Mac Power 1997 January

home *** CD-ROM | disk | FTP | other *** search
/ Mac Power 1997 January / macpower199701.bin / AMUG / Publishing_19 / Alpha 6.5.sit / Help / Apple Events < prev next >
MacBinary | 1995-11-11 | 29.9 KB | [TEXT/ALFA]
open in:
MacOS 8.1 extracted |
Win98 extracted |
DOS extracted
view JSON data |
view as text

This file was processed as: MacBinary (archive/macBinary).

You can browse this item here: Apple Events
Confidence	Program	Detection	Match Type	Support
`10%`	dexvert	MacBinary `(archive/macBinary)`	fallback	Supported
`1%`	dexvert	Text File `(text/txt)`	fallback	Supported
`100%`	file	MacBinary II, inited, Sat Nov 11 22:21:28 1995, modified Sat Nov 11 22:21:28 1995, creator Alpha editor, type ASCII, 29326 bytes "Apple Events" , at 0x730e 1002 bytes resource	default (weak)
`99%`	file	data	default
`74%`	TrID	Macintosh plain text (MacBinary)	default
`25%`	TrID	MacBinary 2	default (weak)
`100%`	siegfried	fmt/1762 MacBinary (II)	default
`100%`	lsar	MacBinary	default
id metadata
key	value
macFileType	`[TEXT]`
macFileCreator	`[ALFA]`
hex view
+--------+-------------------------+-------------------------+--------+--------+
|00000000| 00 0c 41 70 70 6c 65 20 | 45 76 65 6e 74 73 00 00 |..Apple |Events..|
|00000010| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000020| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000030| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000040| 00 54 45 58 54 41 4c 46 | 41 01 00 00 00 00 00 00 |.TEXTALF|A.......|
|00000050| 00 00 00 00 00 72 8e 00 | 00 03 ea ac cb 18 b8 ac |.....r..|........|
|00000060| cb 18 b8 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000070| 00 00 00 00 00 00 00 00 | 00 00 81 81 5a 6d 00 00 |........|....Zm..|
|00000080| 09 09 09 09 41 70 70 6c | 65 20 45 76 65 6e 74 73 |....Appl|e Events|
|00000090| 0d 0d 41 6c 70 68 61 20 | 68 61 73 20 76 65 72 79 |..Alpha |has very|
|000000a0| 20 65 78 74 65 6e 73 69 | 76 65 20 73 75 70 70 6f | extensi|ve suppo|
|000000b0| 72 74 20 66 6f 72 20 73 | 63 72 69 70 74 69 6e 67 |rt for s|cripting|
|000000c0| 20 61 6e 64 20 69 6e 74 | 65 72 2d 61 70 70 6c 69 | and int|er-appli|
|000000d0| 63 61 74 69 6f 6e 20 0d | 63 6f 6d 6d 75 6e 69 63 |cation .|communic|
|000000e0| 61 74 69 6f 6e 2e 20 0d | 0d 09 31 29 20 41 6c 70 |ation. .|..1) Alp|
|000000f0| 68 61 20 69 73 20 63 6f | 6d 70 6c 65 74 65 6c 79 |ha is co|mpletely|
|00000100| 20 73 63 72 69 70 74 61 | 62 6c 65 20 69 6e 20 54 | scripta|ble in T|
|00000110| 63 6c 2c 20 77 68 69 63 | 68 20 69 73 20 66 61 72 |cl, whic|h is far|
|00000120| 20 62 65 74 74 65 72 20 | 73 75 69 74 65 64 20 66 | better |suited f|
|00000130| 6f 72 20 0d 09 20 20 20 | 69 6e 74 65 72 6e 61 6c |or ..   |internal|
|00000140| 20 73 63 72 69 70 74 69 | 6e 67 20 74 68 61 6e 20 | scripti|ng than |
|00000150| 41 70 70 6c 65 53 63 72 | 69 70 74 2e 0d 09 20 20 |AppleScr|ipt...  |
|00000160| 20 0d 09 32 29 20 41 6c | 70 68 61 20 61 63 63 65 | ..2) Al|pha acce|
|00000170| 70 74 73 20 74 68 65 20 | 72 65 71 75 69 72 65 64 |pts the |required|
|00000180| 20 61 70 70 6c 65 20 65 | 76 65 6e 74 73 2c 20 70 | apple e|vents, p|
|00000190| 6c 75 73 20 27 64 6f 73 | 63 27 2c 20 77 68 69 63 |lus 'dos|c', whic|
|000001a0| 68 20 69 73 20 75 73 65 | 64 20 0d 09 20 20 20 74 |h is use|d ..   t|
|000001b0| 6f 20 74 65 6c 6c 20 41 | 6c 70 68 61 20 74 6f 20 |o tell A|lpha to |
|000001c0| 65 78 65 63 75 74 65 20 | 61 20 54 63 6c 20 73 63 |execute |a Tcl sc|
|000001d0| 72 69 70 74 2e 0d 09 20 | 20 20 0d 09 33 29 20 41 |ript... |  ..3) A|
|000001e0| 6c 70 68 61 20 68 61 73 | 20 61 20 63 6f 6d 6d 61 |lpha has| a comma|
|000001f0| 6e 64 2c 20 41 45 42 75 | 69 6c 64 2c 20 77 68 69 |nd, AEBu|ild, whi|
|00000200| 63 68 20 61 6c 6c 6f 77 | 73 20 61 72 62 69 74 72 |ch allow|s arbitr|
|00000210| 61 72 69 6c 79 20 63 6f | 6d 70 6c 69 63 61 74 65 |arily co|mplicate|
|00000220| 64 20 0d 09 20 20 20 61 | 70 70 6c 65 20 65 76 65 |d ..   a|pple eve|
|00000230| 6e 74 73 20 74 6f 20 62 | 65 20 62 75 69 6c 74 20 |nts to b|e built |
|00000240| 61 6e 64 20 73 65 6e 74 | 2e 20 0d 09 20 20 20 0d |and sent|. ..   .|
|00000250| 09 34 29 20 51 75 65 75 | 65 27 64 20 72 65 70 6c |.4) Queu|e'd repl|
|00000260| 69 65 73 20 6f 66 20 6d | 65 73 73 61 67 65 73 20 |ies of m|essages |
|00000270| 73 65 6e 74 20 62 79 20 | 41 45 42 75 69 6c 64 20 |sent by |AEBuild |
|00000280| 61 72 65 20 41 45 50 72 | 69 6e 74 27 64 20 61 6e |are AEPr|int'd an|
|00000290| 64 20 70 61 73 73 65 64 | 20 0d 09 20 20 20 74 6f |d passed| ..   to|
|000002a0| 20 74 68 65 20 74 63 6c | 20 70 72 6f 63 20 68 61 | the tcl| proc ha|
|000002b0| 6e 64 6c 65 52 65 70 6c | 79 20 28 69 6e 20 3a 54 |ndleRepl|y (in :T|
|000002c0| 63 6c 3a 53 79 73 74 65 | 6d 43 6f 64 65 3a 61 70 |cl:Syste|mCode:ap|
|000002d0| 70 6c 65 45 76 65 6e 74 | 73 2e 74 63 6c 29 2e 0d |pleEvent|s.tcl)..|
|000002e0| 09 20 20 20 0d 09 35 29 | 20 41 6c 70 68 61 20 68 |.   ..5)| Alpha h|
|000002f0| 61 73 20 73 65 76 65 72 | 61 6c 20 69 6e 74 65 72 |as sever|al inter|
|00000300| 6e 61 6c 20 68 61 6e 64 | 6c 65 72 73 20 74 6f 20 |nal hand|lers to |
|00000310| 73 75 70 70 6f 72 74 20 | 69 6e 74 65 72 61 63 74 |support |interact|
|00000320| 69 6f 6e 20 77 69 74 68 | 20 0d 20 20 20 09 20 20 |ion with| .   .  |
|00000330| 20 54 68 69 6e 6b 2c 20 | 62 75 74 20 62 61 73 69 | Think, |but basi|
|00000340| 63 61 6c 6c 79 20 74 68 | 65 20 65 6e 74 69 72 65 |cally th|e entire|
|00000350| 20 69 6e 74 65 72 66 61 | 63 65 20 69 73 20 64 6f | interfa|ce is do|
|00000360| 6e 65 20 69 6e 20 54 63 | 6c 20 75 73 69 6e 67 20 |ne in Tc|l using |
|00000370| 0d 20 20 20 09 20 20 20 | 41 45 42 75 69 6c 64 2e |.   .   |AEBuild.|
|00000380| 20 43 6f 6d 70 69 6c 65 | 72 20 65 72 72 6f 72 73 | Compile|r errors|
|00000390| 20 61 72 65 20 70 61 72 | 73 65 64 20 61 6e 64 20 | are par|sed and |
|000003a0| 70 61 73 73 65 64 20 74 | 6f 20 0d 20 20 20 09 20 |passed t|o .   . |
|000003b0| 20 20 27 68 61 6e 64 6c | 65 54 68 69 6e 6b 52 65 |  'handl|eThinkRe|
|000003c0| 70 6c 79 27 2e 0d 0d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |ply'...=|========|
|000003d0| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|000003e0| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|000003f0| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|00000400| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|00000410| 3d 3d 3d 3d 3d 3d 3d 0d | 0d 54 68 65 20 66 6f 6c |=======.|.The fol|
|00000420| 6c 6f 77 69 6e 67 20 69 | 73 20 61 20 74 65 78 74 |lowing i|s a text|
|00000430| 20 76 65 72 73 69 6f 6e | 20 6f 66 20 74 68 65 20 | version| of the |
|00000440| 41 45 42 75 69 6c 64 2f | 41 45 50 72 69 6e 74 20 |AEBuild/|AEPrint |
|00000450| 64 6f 63 73 2e 20 54 68 | 65 20 0d 57 6f 72 64 2d |docs. Th|e .Word-|
|00000460| 66 6f 72 6d 61 74 74 65 | 64 20 6f 72 69 67 69 6e |formatte|d origin|
|00000470| 61 6c 20 69 73 20 69 6e | 63 6c 75 64 65 64 20 69 |al is in|cluded i|
|00000480| 6e 20 3a 4d 69 73 63 2e | 0d 0d 41 70 70 6c 65 20 |n :Misc.|..Apple |
|00000490| 45 76 65 6e 74 73 09 54 | 68 65 20 ae 20 42 75 69 |Events.T|he . Bui|
|000004a0| 6c 64 65 72 2f 50 72 69 | 6e 74 65 72 0d 56 65 72 |lder/Pri|nter.Ver|
|000004b0| 73 69 6f 6e 20 31 2e 33 | 2e 33 0d 0d 4a 65 6e 73 |sion 1.3|.3..Jens|
|000004c0| 20 50 65 74 65 72 20 41 | 6c 66 6b 65 0d 31 31 20 | Peter A|lfke.11 |
|000004d0| 4f 63 74 6f 62 65 72 20 | 31 39 39 33 0d 41 70 70 |October |1993.App|
|000004e0| 6c 65 53 63 72 69 70 74 | 20 54 65 61 6d 0d a9 20 |leScript| Team.. |
|000004f0| 41 70 70 6c 65 20 43 6f | 6d 70 75 74 65 72 2c 20 |Apple Co|mputer, |
|00000500| 49 6e 63 2e 20 31 39 39 | 31 d0 31 39 39 33 0d 0d |Inc. 199|1.1993..|
|00000510| 49 6e 74 72 6f 64 75 63 | 74 69 6f 6e 0d 2d 2d 2d |Introduc|tion.---|
|00000520| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 0d 0d 4f 4b 2c 20 57 |--------|-..OK, W|
|00000530| 68 61 74 20 49 73 20 49 | 74 3f 0d 0d 45 76 65 6e |hat Is I|t?..Even|
|00000540| 20 77 69 74 68 20 74 68 | 65 20 68 65 6c 70 66 75 | with th|e helpfu|
|00000550| 6c 20 4f 62 6a 65 63 74 | 20 53 75 70 70 6f 72 74 |l Object| Support|
|00000560| 20 4c 69 62 72 61 72 79 | 20 72 6f 75 74 69 6e 65 | Library| routine|
|00000570| 73 20 74 68 61 74 20 61 | 73 73 65 6d 62 6c 65 20 |s that a|ssemble |
|00000580| 63 6f 6d 6d 6f 6e 20 0d | 41 70 70 6c 65 20 65 76 |common .|Apple ev|
|00000590| 65 6e 74 20 6f 62 6a 65 | 63 74 20 64 65 73 63 72 |ent obje|ct descr|
|000005a0| 69 70 74 6f 72 73 2c 20 | 62 75 69 6c 64 69 6e 67 |iptors, |building|
|000005b0| 20 64 65 73 63 72 69 70 | 74 6f 72 73 20 61 6e 64 | descrip|tors and|
|000005c0| 20 65 76 65 6e 74 73 20 | 69 73 20 73 74 69 6c 6c | events |is still|
|000005d0| 20 61 20 70 61 69 6e 2e | 20 49 d5 76 65 20 0d 77 | a pain.| I.ve .w|
|000005e0| 72 69 74 74 65 6e 20 61 | 20 6c 69 62 72 61 72 79 |ritten a| library|
|000005f0| 20 6f 66 20 74 77 6f 20 | 66 75 6e 63 74 69 6f 6e | of two |function|
|00000600| 73 20 74 68 61 74 20 6d | 61 6b 65 20 69 74 20 71 |s that m|ake it q|
|00000610| 75 69 63 6b 20 61 6e 64 | 20 65 61 73 79 20 74 6f |uick and| easy to|
|00000620| 20 62 75 69 6c 64 20 6f | 72 20 64 69 73 70 6c 61 | build o|r displa|
|00000630| 79 20 0d 41 70 70 6c 65 | 20 65 76 65 6e 74 20 64 |y .Apple| event d|
|00000640| 65 73 63 72 69 70 74 6f | 72 73 20 61 6e 64 20 74 |escripto|rs and t|
|00000650| 68 65 20 41 70 70 6c 65 | 20 65 76 65 6e 74 73 20 |he Apple| events |
|00000660| 74 68 65 6d 73 65 6c 76 | 65 73 2e 0d 0d 54 68 65 |themselv|es...The|
|00000670| 20 41 45 42 75 69 6c 64 | 20 66 75 6e 63 74 69 6f | AEBuild| functio|
|00000680| 6e 20 74 61 6b 65 73 20 | 61 20 66 6f 72 6d 61 74 |n takes |a format|
|00000690| 20 73 74 72 69 6e 67 20 | d1 20 61 20 64 65 73 63 | string |. a desc|
|000006a0| 72 69 70 74 69 6f 6e 20 | 69 6e 20 61 20 76 65 72 |ription |in a ver|
|000006b0| 79 20 73 69 6d 70 6c 65 | 20 0d 6c 61 6e 67 75 61 |y simple| .langua|
|000006c0| 67 65 20 6f 66 20 61 6e | 20 41 70 70 6c 65 20 65 |ge of an| Apple e|
|000006d0| 76 65 6e 74 20 64 65 73 | 63 72 69 70 74 6f 72 20 |vent des|criptor |
|000006e0| d1 20 61 6e 64 20 67 65 | 6e 65 72 61 74 65 73 20 |. and ge|nerates |
|000006f0| 61 20 72 65 61 6c 20 64 | 65 73 63 72 69 70 74 6f |a real d|escripto|
|00000700| 72 20 28 77 68 69 63 68 | 20 0d 63 6f 75 6c 64 20 |r (which| .could |
|00000710| 62 65 20 61 20 72 65 63 | 6f 72 64 20 6f 72 20 6c |be a rec|ord or l|
|00000720| 69 73 74 20 6f 72 20 65 | 76 65 6e 74 29 20 6f 75 |ist or e|vent) ou|
|00000730| 74 20 6f 66 20 69 74 2e | 20 54 68 65 20 41 45 50 |t of it.| The AEP|
|00000740| 72 69 6e 74 20 66 75 6e | 63 74 69 6f 6e 20 64 6f |rint fun|ction do|
|00000750| 65 73 20 74 68 65 20 72 | 65 76 65 72 73 65 3a 20 |es the r|everse: |
|00000760| 0d 67 69 76 65 6e 20 61 | 6e 20 41 70 70 6c 65 20 |.given a|n Apple |
|00000770| 65 76 65 6e 74 20 64 65 | 73 63 72 69 70 74 6f 72 |event de|scriptor|
|00000780| 2c 20 6c 69 73 74 20 6f | 72 20 72 65 63 6f 72 64 |, list o|r record|
|00000790| 2c 20 69 74 20 70 72 65 | 74 74 79 70 72 69 6e 74 |, it pre|ttyprint|
|000007a0| 73 20 69 74 20 74 6f 20 | 61 20 73 74 72 69 6e 67 |s it to |a string|
|000007b0| 2e 20 28 54 68 65 20 0d | 72 65 73 75 6c 74 69 6e |. (The .|resultin|
|000007c0| 67 20 73 74 72 69 6e 67 | 2c 20 69 66 20 73 65 6e |g string|, if sen|
|000007d0| 74 20 74 6f 20 41 45 42 | 75 69 6c 64 2c 20 77 6f |t to AEB|uild, wo|
|000007e0| 75 6c 64 20 72 65 70 72 | 6f 64 75 63 65 20 74 68 |uld repr|oduce th|
|000007f0| 65 20 6f 72 69 67 69 6e | 61 6c 20 41 45 44 65 73 |e origin|al AEDes|
|00000800| 63 20 0d 73 74 72 75 63 | 74 75 72 65 2e 29 0d 0d |c .struc|ture.)..|
|00000810| 41 45 42 75 69 6c 64 20 | 63 61 6e 20 70 6c 75 67 |AEBuild |can plug|
|00000820| 20 76 61 72 69 61 62 6c | 65 20 70 61 72 61 6d 65 | variabl|e parame|
|00000830| 74 65 72 73 20 69 6e 74 | 6f 20 74 68 65 20 73 74 |ters int|o the st|
|00000840| 72 75 63 74 75 72 65 73 | 20 69 74 20 67 65 6e 65 |ructures| it gene|
|00000850| 72 61 74 65 73 20 d1 20 | 61 73 20 77 69 74 68 20 |rates . |as with |
|00000860| 0d 70 72 69 6e 74 66 2c | 20 61 6c 6c 20 79 6f 75 |.printf,| all you|
|00000870| 20 64 6f 20 69 73 20 70 | 75 74 20 6d 61 72 6b 65 | do is p|ut marke|
|00000880| 72 20 63 68 61 72 61 63 | 74 65 72 73 20 69 6e 20 |r charac|ters in |
|00000890| 74 68 65 20 66 6f 72 6d | 61 74 20 73 74 72 69 6e |the form|at strin|
|000008a0| 67 20 61 6e 64 20 73 75 | 70 70 6c 79 20 74 68 65 |g and su|pply the|
|000008b0| 20 0d 70 61 72 61 6d 65 | 74 65 72 20 76 61 6c 75 | .parame|ter valu|
|000008c0| 65 73 20 61 73 20 65 78 | 74 72 61 20 66 75 6e 63 |es as ex|tra func|
|000008d0| 74 69 6f 6e 20 61 72 67 | 75 6d 65 6e 74 73 2e 0d |tion arg|uments..|
|000008e0| 0d 54 68 65 20 62 65 6e | 65 66 69 74 73 20 6f 66 |.The ben|efits of|
|000008f0| 20 75 73 69 6e 67 20 74 | 68 69 73 20 6c 69 62 72 | using t|his libr|
|00000900| 61 72 79 20 61 72 65 20 | 66 6f 75 72 66 6f 6c 64 |ary are |fourfold|
|00000910| 3a 0d 0d 09 a5 09 49 74 | d5 73 20 65 61 73 69 65 |:.....It|.s easie|
|00000920| 72 20 66 6f 72 20 79 6f | 75 20 74 6f 20 77 72 69 |r for yo|u to wri|
|00000930| 74 65 20 74 68 65 20 63 | 6f 64 65 20 74 6f 20 62 |te the c|ode to b|
|00000940| 75 69 6c 64 20 41 70 70 | 6c 65 20 65 76 65 6e 74 |uild App|le event|
|00000950| 20 73 74 72 75 63 74 75 | 72 65 73 2e 20 59 6f 75 | structu|res. You|
|00000960| 20 0d 09 09 6f 6e 6c 79 | 20 68 61 76 65 20 74 6f | ...only| have to|
|00000970| 20 72 65 6d 65 6d 62 65 | 72 20 6f 6e 65 20 66 75 | remembe|r one fu|
|00000980| 6e 63 74 69 6f 6e 20 63 | 61 6c 6c 20 61 6e 64 20 |nction c|all and |
|00000990| 61 20 66 65 77 20 73 69 | 6d 70 6c 65 20 73 79 6e |a few si|mple syn|
|000009a0| 74 61 78 20 72 75 6c 65 | 73 2e 20 0d 09 09 59 6f |tax rule|s. ...Yo|
|000009b0| 75 72 20 72 65 73 75 6c | 74 69 6e 67 20 63 6f 64 |ur resul|ting cod|
|000009c0| 65 20 69 73 20 61 6c 73 | 6f 20 65 61 73 69 65 72 |e is als|o easier|
|000009d0| 20 74 6f 20 75 6e 64 65 | 72 73 74 61 6e 64 2e 0d | to unde|rstand..|
|000009e0| 0d 09 a5 09 41 73 20 6f | 66 20 76 65 72 73 69 6f |....As o|f versio|
|000009f0| 6e 20 31 2e 32 2c 20 79 | 6f 75 72 20 63 6f 64 65 |n 1.2, y|our code|
|00000a00| 20 69 73 20 65 76 65 6e | 20 66 61 73 74 65 72 3a | is even| faster:|
|00000a10| 20 41 45 42 75 69 6c 64 | 20 69 73 20 74 68 72 65 | AEBuild| is thre|
|00000a20| 65 20 74 6f 20 66 6f 75 | 72 20 74 69 6d 65 73 20 |e to fou|r times |
|00000a30| 0d 09 09 61 73 20 66 61 | 73 74 20 61 73 20 74 68 |...as fa|st as th|
|00000a40| 65 20 72 65 67 75 6c 61 | 72 20 41 70 70 6c 65 20 |e regula|r Apple |
|00000a50| 45 76 65 6e 74 20 4d 61 | 6e 61 67 65 72 20 72 6f |Event Ma|nager ro|
|00000a60| 75 74 69 6e 65 73 20 61 | 74 20 63 6f 6e 73 74 72 |utines a|t constr|
|00000a70| 75 63 74 69 6e 67 20 0d | 09 09 63 6f 6d 70 6c 65 |ucting .|..comple|
|00000a80| 78 20 73 74 72 75 63 74 | 75 72 65 73 2e 20 28 59 |x struct|ures. (Y|
|00000a90| 6f 75 72 20 6d 69 6c 65 | 61 67 65 20 6d 61 79 20 |our mile|age may |
|00000aa0| 76 61 72 79 2e 29 0d 0d | 09 a5 09 59 6f 75 72 20 |vary.)..|...Your |
|00000ab0| 63 6f 64 65 20 69 73 20 | 73 6d 61 6c 6c 65 72 3a |code is |smaller:|
|00000ac0| 20 74 68 65 20 63 6f 64 | 65 20 66 6f 72 20 41 45 | the cod|e for AE|
|00000ad0| 42 75 69 6c 64 20 61 6e | 64 20 74 68 65 20 41 45 |Build an|d the AE|
|00000ae0| 53 74 72 65 61 6d 20 6c | 69 62 72 61 72 79 20 69 |Stream l|ibrary i|
|00000af0| 73 20 0d 09 09 61 62 6f | 75 74 20 36 6b 20 69 6e |s ...abo|ut 6k in|
|00000b00| 20 73 69 7a 65 2c 20 61 | 6e 64 20 74 68 65 20 6f | size, a|nd the o|
|00000b10| 76 65 72 68 65 61 64 20 | 66 6f 72 20 65 61 63 68 |verhead |for each|
|00000b20| 20 63 61 6c 6c 20 69 73 | 20 6d 69 6e 69 6d 61 6c | call is| minimal|
|00000b30| 2e 20 28 4d 6f 73 74 20 | 6f 66 20 74 68 65 20 0d |. (Most |of the .|
|00000b40| 09 09 64 65 73 63 72 69 | 70 74 6f 72 20 73 74 72 |..descri|ptor str|
|00000b50| 69 6e 67 20 63 6f 6e 73 | 69 73 74 73 20 6f 66 20 |ing cons|ists of |
|00000b60| 74 68 65 20 73 61 6d 65 | 20 66 6f 75 72 2d 6c 65 |the same| four-le|
|00000b70| 74 74 65 72 20 63 6f 64 | 65 73 20 79 6f 75 d5 64 |tter cod|es you.d|
|00000b80| 20 62 65 20 75 73 69 6e | 67 20 69 6e 20 0d 09 09 | be usin|g in ...|
|00000b90| 79 6f 75 72 20 70 72 6f | 67 72 61 6d 20 63 6f 64 |your pro|gram cod|
|00000ba0| 65 20 61 6e 79 77 61 79 | 2c 20 61 6e 64 20 74 68 |e anyway|, and th|
|00000bb0| 65 20 73 74 72 69 6e 67 | 73 20 63 61 6e 20 65 76 |e string|s can ev|
|00000bc0| 65 6e 20 62 65 20 73 74 | 6f 72 65 64 20 69 6e 20 |en be st|ored in |
|00000bd0| 0d 09 09 72 65 73 6f 75 | 72 63 65 73 20 66 6f 72 |...resou|rces for|
|00000be0| 20 6d 6f 72 65 20 63 6f | 64 65 20 73 61 76 69 6e | more co|de savin|
|00000bf0| 67 73 2e 29 0d 09 09 0d | 09 a5 09 41 45 50 72 69 |gs.)....|...AEPri|
|00000c00| 6e 74 20 68 65 6c 70 73 | 20 69 6e 20 64 65 62 75 |nt helps| in debu|
|00000c10| 67 67 69 6e 67 20 70 72 | 6f 67 72 61 6d 73 2c 20 |gging pr|ograms, |
|00000c20| 62 79 20 74 75 72 6e 69 | 6e 67 20 6d 79 73 74 65 |by turni|ng myste|
|00000c30| 72 69 6f 75 73 20 41 45 | 44 65 73 63 20 0d 09 09 |rious AE|Desc ...|
|00000c40| 73 74 72 75 63 74 75 72 | 65 73 20 69 6e 74 6f 20 |structur|es into |
|00000c50| 68 75 6d 61 6e 2d 72 65 | 61 64 61 62 6c 65 20 74 |human-re|adable t|
|00000c60| 65 78 74 2e 0d 0d 57 68 | 61 74 d5 73 20 4e 65 77 |ext...Wh|at.s New|
|00000c70| 3f 0d 20 0d 49 6e 20 76 | 65 72 73 69 6f 6e 20 31 |?. .In v|ersion 1|
|00000c80| 2e 33 3a 0d 0d a5 09 41 | 20 6e 65 77 20 66 75 6e |.3:....A| new fun|
|00000c90| 63 74 69 6f 6e 2c 20 41 | 45 50 72 69 6e 74 53 69 |ction, A|EPrintSi|
|00000ca0| 7a 65 2c 20 63 6f 6d 70 | 75 74 65 73 20 68 6f 77 |ze, comp|utes how|
|00000cb0| 20 6c 6f 6e 67 20 74 68 | 65 20 73 74 72 69 6e 67 | long th|e string|
|00000cc0| 20 62 75 69 6c 74 20 62 | 79 20 41 45 50 72 69 6e | built b|y AEPrin|
|00000cd0| 74 20 0d 09 77 6f 75 6c | 64 20 62 65 2c 20 77 69 |t ..woul|d be, wi|
|00000ce0| 74 68 6f 75 74 20 61 63 | 74 75 61 6c 6c 79 20 63 |thout ac|tually c|
|00000cf0| 72 65 61 74 69 6e 67 20 | 69 74 2e 20 54 68 69 73 |reating |it. This|
|00000d00| 20 69 73 20 75 73 65 66 | 75 6c 20 69 66 20 79 6f | is usef|ul if yo|
|00000d10| 75 20 77 61 6e 74 20 74 | 6f 20 61 6c 6c 6f 63 61 |u want t|o alloca|
|00000d20| 74 65 20 0d 09 73 74 6f | 72 61 67 65 20 66 6f 72 |te ..sto|rage for|
|00000d30| 20 74 68 65 20 73 74 72 | 69 6e 67 20 64 79 6e 61 | the str|ing dyna|
|00000d40| 6d 69 63 61 6c 6c 79 2e | 0d 0d a5 09 41 45 50 72 |mically.|....AEPr|
|00000d50| 69 6e 74 20 6e 6f 20 6c | 6f 6e 67 65 72 20 74 72 |int no l|onger tr|
|00000d60| 75 6e 63 61 74 65 73 20 | 68 65 78 20 64 75 6d 70 |uncates |hex dump|
|00000d70| 73 20 28 6f 66 20 75 6e | 6b 6e 6f 77 6e 20 64 65 |s (of un|known de|
|00000d80| 73 63 72 69 70 74 6f 72 | 73 29 20 61 66 74 65 72 |scriptor|s) after|
|00000d90| 20 33 32 20 0d 09 62 79 | 74 65 73 2e 0d 0d 41 6e | 32 ..by|tes...An|
|00000da0| 64 20 69 6e 20 76 65 72 | 73 69 6f 6e 20 31 2e 33 |d in ver|sion 1.3|
|00000db0| 2e 32 3a 0d 0d a5 09 41 | 45 50 72 69 6e 74 20 6e |.2:....A|EPrint n|
|00000dc0| 6f 20 6c 6f 6e 67 65 72 | 20 75 73 65 73 20 74 68 |o longer| uses th|
|00000dd0| 65 20 73 74 64 69 6f 20 | 6c 69 62 72 61 72 79 2e |e stdio |library.|
|00000de0| 20 54 68 69 73 20 73 68 | 6f 75 6c 64 20 68 65 6c | This sh|ould hel|
|00000df0| 70 20 72 65 64 75 63 65 | 20 63 6f 64 65 20 73 69 |p reduce| code si|
|00000e00| 7a 65 20 0d 09 28 61 6e | 64 20 65 6c 69 6d 69 6e |ze ..(an|d elimin|
|00000e10| 61 74 65 20 73 6f 6d 65 | 20 70 72 6f 62 6c 65 6d |ate some| problem|
|00000e20| 73 20 69 6e 20 63 6f 64 | 65 20 72 65 73 6f 75 72 |s in cod|e resour|
|00000e30| 63 65 73 29 20 62 75 74 | 20 74 6f 20 64 6f 20 69 |ces) but| to do i|
|00000e40| 74 20 49 20 68 61 64 20 | 74 6f 20 63 72 69 70 70 |t I had |to cripp|
|00000e50| 6c 65 20 0d 09 66 6c 6f | 61 74 69 6e 67 2d 70 6f |le ..flo|ating-po|
|00000e60| 69 6e 74 20 64 69 73 70 | 6c 61 79 2e 20 46 6c 6f |int disp|lay. Flo|
|00000e70| 61 74 69 6e 67 2d 70 6f | 69 6e 74 20 64 65 73 63 |ating-po|int desc|
|00000e80| 72 69 70 74 6f 72 73 20 | 6e 6f 77 20 70 72 69 6e |riptors |now prin|
|00000e90| 74 20 61 73 20 74 68 65 | 20 69 6e 74 65 67 65 72 |t as the| integer|
|00000ea0| 20 70 61 72 74 20 0d 09 | 66 6f 6c 6c 6f 77 65 64 | part ..|followed|
|00000eb0| 20 62 79 20 d2 2e 58 58 | 58 58 d3 2e 0d 09 0d 41 | by ..XX|XX.....A|
|00000ec0| 6e 64 20 69 6e 20 76 65 | 72 73 69 6f 6e 20 31 2e |nd in ve|rsion 1.|
|00000ed0| 33 2e 33 3a 0d 0d a5 09 | 41 66 74 65 72 20 61 20 |3.3:....|After a |
|00000ee0| 62 72 69 6c 6c 69 61 6e | 74 20 73 75 67 67 65 73 |brillian|t sugges|
|00000ef0| 74 69 6f 6e 20 62 79 20 | 52 6f 62 20 44 79 65 2c |tion by |Rob Dye,|
|00000f00| 20 41 45 50 72 69 6e 74 | 20 6e 6f 77 20 75 73 65 | AEPrint| now use|
|00000f10| 73 20 74 68 65 20 62 75 | 69 6c 74 20 69 6e 20 66 |s the bu|ilt in f|
|00000f20| 6c 6f 61 74 2d 0d 09 74 | 6f 2d 74 65 78 74 20 63 |loat-..t|o-text c|
|00000f30| 6f 65 72 63 69 6f 6e 20 | 74 6f 20 64 69 73 70 6c |oercion |to displ|
|00000f40| 61 79 20 66 6c 6f 61 74 | 69 6e 67 2d 70 6f 69 6e |ay float|ing-poin|
|00000f50| 74 20 64 65 73 63 72 69 | 70 74 6f 72 73 2e 0d 0d |t descri|ptors...|
|00000f60| a5 09 46 69 78 65 64 20 | 61 20 70 6f 73 73 69 62 |..Fixed |a possib|
|00000f70| 6c 65 20 70 72 6f 62 6c | 65 6d 20 77 69 74 68 20 |le probl|em with |
|00000f80| 41 45 42 75 69 6c 64 20 | 69 6e 70 75 74 20 73 74 |AEBuild |input st|
|00000f90| 72 69 6e 67 73 20 63 6f | 6e 74 61 69 6e 69 6e 67 |rings co|ntaining|
|00000fa0| 20 52 65 74 75 72 6e 20 | 0d 09 63 68 61 72 61 63 | Return |..charac|
|00000fb0| 74 65 72 73 2c 20 69 6e | 20 74 68 65 20 4d 50 57 |ters, in| the MPW|
|00000fc0| 20 76 65 72 73 69 6f 6e | 20 6f 66 20 74 68 65 20 | version| of the |
|00000fd0| 6c 69 62 72 61 72 79 2e | 0d 0d 48 6f 77 20 54 6f |library.|..How To|
|00000fe0| 20 43 61 6c 6c 20 74 68 | 65 20 46 75 6e 63 74 69 | Call th|e Functi|
|00000ff0| 6f 6e 73 0d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |ons.----|--------|
|00001000| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 0d 0d 54 |--------|-----..T|
|00001010| 68 65 73 65 20 61 72 65 | 20 61 6c 6c 20 43 20 66 |hese are| all C f|
|00001020| 75 6e 63 74 69 6f 6e 73 | 2e 20 54 68 65 79 20 61 |unctions|. They a|
|00001030| 6c 6c 20 74 61 6b 65 20 | 76 61 72 69 61 62 6c 65 |ll take |variable|
|00001040| 20 6e 75 6d 62 65 72 73 | 20 6f 66 20 61 72 67 75 | numbers| of argu|
|00001050| 6d 65 6e 74 73 2c 20 73 | 6f 20 74 68 65 79 d5 64 |ments, s|o they.d|
|00001060| 20 0d 62 65 20 64 69 66 | 66 69 63 75 6c 74 20 6f | .be dif|ficult o|
|00001070| 72 20 69 6d 70 6f 73 73 | 69 62 6c 65 20 74 6f 20 |r imposs|ible to |
|00001080| 63 61 6c 6c 20 66 72 6f | 6d 20 50 61 73 63 61 6c |call fro|m Pascal|
|00001090| 2c 20 61 6e 79 77 61 79 | 2e 20 28 41 6e 64 20 72 |, anyway|. (And r|
|000010a0| 65 6d 65 6d 62 65 72 2c | 20 6b 69 64 73 3a 20 74 |emember,| kids: t|
|000010b0| 68 65 72 65 20 0d 61 72 | 65 20 6e 6f 20 50 61 73 |here .ar|e no Pas|
|000010c0| 63 61 6c 20 63 6f 6d 70 | 69 6c 65 72 73 20 66 6f |cal comp|ilers fo|
|000010d0| 72 20 74 68 65 20 50 6f | 77 65 72 50 43 20 63 68 |r the Po|werPC ch|
|000010e0| 69 70 c9 29 0d 0d 41 45 | 42 75 69 6c 64 0d 0d 4f |ip.)..AE|Build..O|
|000010f0| 53 45 72 72 0d 09 41 45 | 42 75 69 6c 64 28 20 20 |SErr..AE|Build(  |
|00001100| 41 45 44 65 73 63 20 2a | 64 65 73 63 2c 20 63 6f |AEDesc *|desc, co|
|00001110| 6e 73 74 20 63 68 61 72 | 20 2a 64 65 73 63 72 69 |nst char| *descri|
|00001120| 70 74 6f 72 53 74 72 2c | 20 2e 2e 2e 20 29 2c 0d |ptorStr,| ... ),.|
|00001130| 09 76 41 45 42 75 69 6c | 64 28 20 41 45 44 65 73 |.vAEBuil|d( AEDes|
|00001140| 63 20 2a 64 65 73 63 2c | 20 63 6f 6e 73 74 20 63 |c *desc,| const c|
|00001150| 68 61 72 20 2a 64 65 73 | 63 72 69 70 74 6f 72 53 |har *des|criptorS|
|00001160| 74 72 2c 20 76 6f 69 64 | 20 2a 61 72 67 73 20 29 |tr, void| *args )|
|00001170| 3b 0d 0d 41 45 42 75 69 | 6c 64 20 72 65 61 64 73 |;..AEBui|ld reads|
|00001180| 20 61 20 6e 75 6c 6c 2d | 74 65 72 6d 69 6e 61 74 | a null-|terminat|
|00001190| 65 64 20 64 65 73 63 72 | 69 70 74 6f 72 20 73 74 |ed descr|iptor st|
|000011a0| 72 69 6e 67 20 28 75 73 | 75 61 6c 6c 79 20 61 20 |ring (us|ually a |
|000011b0| 63 6f 6e 73 74 61 6e 74 | 2c 20 61 6c 74 68 6f 75 |constant|, althou|
|000011c0| 67 68 20 69 74 20 0d 63 | 6f 75 6c 64 20 63 6f 6d |gh it .c|ould com|
|000011d0| 65 20 66 72 6f 6d 20 61 | 6e 79 77 68 65 72 65 29 |e from a|nywhere)|
|000011e0| 2c 20 70 61 72 73 65 73 | 20 69 74 20 61 6e 64 20 |, parses| it and |
|000011f0| 62 75 69 6c 64 73 20 61 | 20 63 6f 72 72 65 73 70 |builds a| corresp|
|00001200| 6f 6e 64 69 6e 67 20 41 | 45 44 65 73 63 20 0d 73 |onding A|EDesc .s|
|00001210| 74 72 75 63 74 75 72 65 | 2e 20 28 44 6f 6e d5 74 |tructure|. (Don.t|
|00001220| 20 77 6f 72 72 79 2c 20 | 49 d5 6c 6c 20 64 65 73 | worry, |I.ll des|
|00001230| 63 72 69 62 65 20 74 68 | 65 20 73 79 6e 74 61 78 |cribe th|e syntax|
|00001240| 20 6f 66 20 74 68 65 20 | 64 65 73 63 72 69 70 74 | of the |descript|
|00001250| 6f 72 20 73 74 72 69 6e | 67 20 69 6e 20 74 68 65 |or strin|g in the|
|00001260| 20 0d 6e 65 78 74 20 73 | 65 63 74 69 6f 6e 2e 29 | .next s|ection.)|
|00001270| 20 49 66 20 74 68 65 20 | 64 65 73 63 72 69 70 74 | If the |descript|
|00001280| 6f 72 20 73 74 72 69 6e | 67 20 63 6f 6e 74 61 69 |or strin|g contai|
|00001290| 6e 73 20 6d 61 67 69 63 | 20 70 61 72 61 6d 65 74 |ns magic| paramet|
|000012a0| 65 72 2d 73 75 62 73 74 | 69 74 75 74 69 6f 6e 20 |er-subst|itution |
|000012b0| 0d 63 68 61 72 61 63 74 | 65 72 73 20 28 d2 40 d3 |.charact|ers (.@.|
|000012c0| 29 20 74 68 65 6e 20 63 | 6f 72 72 65 73 70 6f 6e |) then c|orrespon|
|000012d0| 64 69 6e 67 20 76 61 6c | 75 65 73 20 6f 66 20 74 |ding val|ues of t|
|000012e0| 68 65 20 63 6f 72 72 65 | 63 74 20 74 79 70 65 20 |he corre|ct type |
|000012f0| 6d 75 73 74 20 62 65 20 | 73 75 70 70 6c 69 65 64 |must be |supplied|
|00001300| 20 0d 61 73 20 66 75 6e | 63 74 69 6f 6e 20 61 72 | .as fun|ction ar|
|00001310| 67 75 6d 65 6e 74 73 2c | 20 6a 75 73 74 20 61 73 |guments,| just as|
|00001320| 20 77 69 74 68 20 70 72 | 69 6e 74 66 2e 0d 0d 28 | with pr|intf...(|
|00001330| 76 41 45 42 75 69 6c 64 | 20 69 73 20 61 6e 61 6c |vAEBuild| is anal|
|00001340| 6f 67 6f 75 73 20 74 6f | 20 76 70 72 69 6e 74 66 |ogous to| vprintf|
|00001350| 3a 20 49 6e 73 74 65 61 | 64 20 6f 66 20 70 61 73 |: Instea|d of pas|
|00001360| 73 69 6e 67 20 74 68 65 | 20 70 61 72 61 6d 65 74 |sing the| paramet|
|00001370| 65 72 73 20 61 6c 6f 6e | 67 20 77 69 74 68 20 0d |ers alon|g with .|
|00001380| 74 68 65 20 66 75 6e 63 | 74 69 6f 6e 2c 20 79 6f |the func|tion, yo|
|00001390| 75 20 73 75 70 70 6c 79 | 20 61 20 76 61 5f 6c 69 |u supply| a va_li|
|000013a0| 73 74 2c 20 61 73 20 64 | 65 66 69 6e 65 64 20 69 |st, as d|efined i|
|000013b0| 6e 20 3c 73 74 64 61 72 | 67 2e 68 3e 2c 20 74 68 |n <stdar|g.h>, th|
|000013c0| 61 74 20 70 6f 69 6e 74 | 73 20 74 6f 20 74 68 65 |at point|s to the|
|000013d0| 20 0d 70 61 72 61 6d 65 | 74 65 72 20 6c 69 73 74 | .parame|ter list|
|000013e0| 2e 20 49 74 d5 73 20 6f | 74 68 65 72 77 69 73 65 |. It.s o|therwise|
|000013f0| 20 69 64 65 6e 74 69 63 | 61 6c 2e 29 0d 0d 41 45 | identic|al.)..AE|
|00001400| 42 75 69 6c 64 20 72 65 | 74 75 72 6e 73 20 61 6e |Build re|turns an|
|00001410| 20 4f 53 45 72 72 2e 20 | 41 6e 79 20 65 72 72 6f | OSErr. |Any erro|
|00001420| 72 73 20 72 65 74 75 72 | 6e 65 64 20 62 79 20 41 |rs retur|ned by A|
|00001430| 70 70 6c 65 20 45 76 65 | 6e 74 20 4d 61 6e 61 67 |pple Eve|nt Manag|
|00001440| 65 72 20 72 6f 75 74 69 | 6e 65 73 20 0d 77 68 69 |er routi|nes .whi|
|00001450| 6c 65 20 62 75 69 6c 64 | 69 6e 67 20 74 68 65 20 |le build|ing the |
|00001460| 64 65 73 63 72 69 70 74 | 6f 72 20 77 69 6c 6c 20 |descript|or will |
|00001470| 62 65 20 73 65 6e 74 20 | 62 61 63 6b 20 74 6f 20 |be sent |back to |
|00001480| 79 6f 75 2e 20 54 68 65 | 20 6d 6f 73 74 20 6c 69 |you. The| most li|
|00001490| 6b 65 6c 79 20 72 65 73 | 75 6c 74 73 20 61 72 65 |kely res|ults are|
|000014a0| 20 0d 6d 65 6d 46 75 6c | 6c 45 72 72 20 61 6e 64 | .memFul|lErr and|
|000014b0| 20 65 72 72 41 45 43 6f | 65 72 63 69 6f 6e 46 61 | errAECo|ercionFa|
|000014c0| 69 6c 2e 20 41 6c 73 6f | 20 6c 69 6b 65 6c 79 20 |il. Also| likely |
|000014d0| 69 73 20 61 65 42 75 69 | 6c 64 53 79 6e 74 61 78 |is aeBui|ldSyntax|
|000014e0| 45 72 72 2c 20 72 65 73 | 75 6c 74 69 6e 67 20 0d |Err, res|ulting .|
|000014f0| 66 72 6f 6d 20 61 6e 20 | 69 6e 63 6f 72 72 65 63 |from an |incorrec|
|00001500| 74 20 64 65 73 63 72 69 | 70 74 6f 72 20 73 74 72 |t descri|ptor str|
|00001510| 69 6e 67 2e 20 28 4d 61 | 6b 65 20 73 75 72 65 20 |ing. (Ma|ke sure |
|00001520| 74 6f 20 64 65 62 75 67 | 20 79 6f 75 72 20 64 65 |to debug| your de|
|00001530| 73 63 72 69 70 74 6f 72 | 20 73 74 72 69 6e 67 73 |scriptor| strings|
|00001540| 2c 20 0d 70 65 72 68 61 | 70 73 20 75 73 69 6e 67 |, .perha|ps using|
|00001550| 20 74 68 65 20 64 65 6d | 6f 20 61 70 70 6c 69 63 | the dem|o applic|
|00001560| 61 74 69 6f 6e 2c 20 62 | 65 66 6f 72 65 20 79 6f |ation, b|efore yo|
|00001570| 75 20 70 75 74 20 74 68 | 65 6d 20 69 6e 20 70 72 |u put th|em in pr|
|00001580| 6f 67 72 61 6d 73 21 29 | 0d 54 68 65 20 62 61 73 |ograms!)|.The bas|
|00001590| 69 63 20 76 65 72 73 69 | 6f 6e 20 6f 66 20 41 45 |ic versi|on of AE|
|000015a0| 42 75 69 6c 64 20 6a 75 | 73 74 20 72 65 70 6f 72 |Build ju|st repor|
|000015b0| 74 73 20 74 68 61 74 20 | 61 20 73 79 6e 74 61 78 |ts that |a syntax|
|000015c0| 20 65 72 72 6f 72 20 6f | 63 63 75 72 72 65 64 2c | error o|ccurred,|
|000015d0| 20 77 69 74 68 6f 75 74 | 20 0d 67 69 76 69 6e 67 | without| .giving|
|000015e0| 20 61 6e 79 20 61 64 64 | 69 74 69 6f 6e 61 6c 20 | any add|itional |
|000015f0| 69 6e 66 6f 72 6d 61 74 | 69 6f 6e 2e 20 49 66 20 |informat|ion. If |
|00001600| 79 6f 75 20 77 61 6e 74 | 20 74 6f 20 6b 6e 6f 77 |you want| to know|
|00001610| 20 6d 6f 72 65 20 28 70 | 65 72 68 61 70 73 20 74 | more (p|erhaps t|
|00001620| 68 65 20 73 74 72 69 6e | 67 20 0d 63 61 6d 65 20 |he strin|g .came |
|00001630| 66 72 6f 6d 20 61 20 75 | 73 65 72 2c 20 74 6f 20 |from a u|ser, to |
|00001640| 77 68 6f 6d 20 79 6f 75 | d5 64 20 6c 69 6b 65 20 |whom you|.d like |
|00001650| 74 6f 20 72 65 70 6f 72 | 74 20 61 20 68 65 6c 70 |to repor|t a help|
|00001660| 66 75 6c 20 65 72 72 6f | 72 20 6d 65 73 73 61 67 |ful erro|r messag|
|00001670| 65 29 20 79 6f 75 20 63 | 61 6e 20 0d 75 73 65 20 |e) you c|an .use |
|00001680| 74 68 65 20 6f 74 68 65 | 72 20 76 65 72 73 69 6f |the othe|r versio|
|00001690| 6e 20 6f 66 20 74 68 65 | 20 6c 69 62 72 61 72 79 |n of the| library|
|000016a0| 2e 20 54 68 69 73 20 76 | 65 72 73 69 6f 6e 20 69 |. This v|ersion i|
|000016b0| 6e 63 6c 75 64 65 73 20 | 61 20 77 65 65 20 62 69 |ncludes |a wee bi|
|000016c0| 74 20 6f 66 20 65 78 74 | 72 61 20 63 6f 64 65 2c |t of ext|ra code,|
|000016d0| 20 0d 61 6e 64 20 74 77 | 6f 20 67 6c 6f 62 61 6c | .and tw|o global|
|000016e0| 20 76 61 72 69 61 62 6c | 65 73 20 74 68 61 74 20 | variabl|es that |
|000016f0| 77 69 6c 6c 20 63 6f 6e | 74 61 69 6e 20 75 73 65 |will con|tain use|
|00001700| 66 75 6c 20 69 6e 66 6f | 72 6d 61 74 69 6f 6e 20 |ful info|rmation |
|00001710| 61 66 74 65 72 20 61 20 | 73 79 6e 74 61 78 20 65 |after a |syntax e|
|00001720| 72 72 6f 72 3a 0d 0d 65 | 78 74 65 72 6e 20 41 45 |rror:..e|xtern AE|
|00001730| 42 75 69 6c 64 5f 53 79 | 6e 74 61 78 45 72 72 54 |Build_Sy|ntaxErrT|
|00001740| 79 70 65 0d 09 41 45 42 | 75 69 6c 64 5f 45 72 72 |ype..AEB|uild_Err|
|00001750| 43 6f 64 65 3b 0d 65 78 | 74 65 72 6e 20 6c 6f 6e |Code;.ex|tern lon|
|00001760| 67 0d 09 41 45 42 75 69 | 6c 64 5f 45 72 72 50 6f |g..AEBui|ld_ErrPo|
|00001770| 73 3b 0d 0d 41 45 42 75 | 69 6c 64 5f 45 72 72 43 |s;..AEBu|ild_ErrC|
|00001780| 6f 64 65 20 69 73 20 61 | 6e 20 65 6e 75 6d 65 72 |ode is a|n enumer|
|00001790| 61 74 65 64 20 76 61 6c | 75 65 20 74 68 61 74 20 |ated val|ue that |
|000017a0| 77 69 6c 6c 20 63 6f 6e | 74 61 69 6e 20 61 20 73 |will con|tain a s|
|000017b0| 70 65 63 69 66 69 63 20 | 65 72 72 6f 72 20 63 6f |pecific |error co|
|000017c0| 64 65 2e 20 0d 54 68 65 | 20 65 72 72 6f 72 20 63 |de. .The| error c|
|000017d0| 6f 64 65 73 20 61 72 65 | 20 64 65 66 69 6e 65 64 |odes are| defined|
|000017e0| 20 69 6e 20 41 45 42 75 | 69 6c 64 2e 68 2e 20 41 | in AEBu|ild.h. A|
|000017f0| 45 42 75 69 6c 64 5f 45 | 72 72 50 6f 73 20 77 69 |EBuild_E|rrPos wi|
|00001800| 6c 6c 20 63 6f 6e 74 61 | 69 6e 20 74 68 65 20 69 |ll conta|in the i|
|00001810| 6e 64 65 78 20 0d 69 6e | 74 6f 20 74 68 65 20 64 |ndex .in|to the d|
|00001820| 65 73 63 72 69 70 74 6f | 72 20 73 74 72 69 6e 67 |escripto|r string|
|00001830| 20 61 74 20 77 68 69 63 | 68 20 74 68 65 20 65 72 | at whic|h the er|
|00001840| 72 6f 72 20 6f 63 63 75 | 72 72 65 64 3a 20 75 73 |ror occu|rred: us|
|00001850| 75 61 6c 6c 79 20 6f 6e | 65 20 63 68 61 72 61 63 |ually on|e charac|
|00001860| 74 65 72 20 70 61 73 74 | 20 0d 74 68 65 20 65 6e |ter past| .the en|
|00001870| 64 20 6f 66 20 74 68 65 | 20 6f 66 66 65 6e 64 69 |d of the| offendi|
|00001880| 6e 67 20 74 6f 6b 65 6e | 2e 0d 41 45 42 75 69 6c |ng token|..AEBuil|
|00001890| 64 50 61 72 61 6d 65 74 | 65 72 73 0d 0d 41 45 42 |dParamet|ers..AEB|
|000018a0| 75 69 6c 64 50 61 72 61 | 6d 65 74 65 72 73 0d 0d |uildPara|meters..|
|000018b0| 4f 53 45 72 72 09 41 45 | 42 75 69 6c 64 50 61 72 |OSErr.AE|BuildPar|
|000018c0| 61 6d 65 74 65 72 73 28 | 20 20 41 70 70 6c 65 45 |ameters(|  AppleE|
|000018d0| 76 65 6e 74 20 2a 65 76 | 65 6e 74 2c 20 63 6f 6e |vent *ev|ent, con|
|000018e0| 73 74 20 63 68 61 72 20 | 2a 64 65 73 63 72 69 70 |st char |*descrip|
|000018f0| 74 6f 72 53 74 72 2c 20 | 2e 2e 2e 20 29 3b 0d 0d |torStr, |... );..|
|00001900| 41 45 42 75 69 6c 64 50 | 61 72 61 6d 65 74 65 72 |AEBuildP|arameter|
|00001910| 73 20 61 64 64 73 20 70 | 61 72 61 6d 65 74 65 72 |s adds p|arameter|
|00001920| 73 20 61 6e 64 2f 6f 72 | 20 61 74 74 72 69 62 75 |s and/or| attribu|
|00001930| 74 65 73 20 74 6f 20 61 | 6e 20 65 78 69 73 74 69 |tes to a|n existi|
|00001940| 6e 67 20 41 70 70 6c 65 | 20 0d 65 76 65 6e 74 2e |ng Apple| .event.|
|00001950| 20 64 65 73 63 72 69 70 | 74 6f 72 53 74 72 20 73 | descrip|torStr s|
|00001960| 70 65 63 69 66 69 65 73 | 20 74 68 65 20 70 61 72 |pecifies| the par|
|00001970| 61 6d 65 74 65 72 73 20 | 28 72 65 71 75 69 72 65 |ameters |(require|
|00001980| 64 20 61 6e 64 20 6f 70 | 74 69 6f 6e 61 6c 29 20 |d and op|tional) |
|00001990| 61 6e 64 20 0d 61 74 74 | 72 69 62 75 74 65 73 2e |and .att|ributes.|
|000019a0| 20 49 74 73 20 73 79 6e | 74 61 78 20 69 73 20 64 | Its syn|tax is d|
|000019b0| 65 73 63 72 69 62 65 64 | 20 62 65 6c 6f 77 20 28 |escribed| below (|
|000019c0| 73 65 65 20 65 73 70 65 | 63 69 61 6c 6c 79 20 74 |see espe|cially t|
|000019d0| 68 65 20 41 70 70 6c 65 | 20 45 76 65 6e 74 20 0d |he Apple| Event .|
|000019e0| 44 65 73 63 72 69 70 74 | 6f 72 20 53 74 72 69 6e |Descript|or Strin|
|000019f0| 67 73 20 73 75 62 73 65 | 63 74 69 6f 6e 29 3b 20 |gs subse|ction); |
|00001a00| 69 74 d5 73 20 61 6c 6d | 6f 73 74 20 74 68 65 20 |it.s alm|ost the |
|00001a10| 73 61 6d 65 20 61 73 20 | 74 68 65 20 73 79 6e 74 |same as |the synt|
|00001a20| 61 78 20 66 6f 72 20 41 | 45 42 75 69 6c 64 2c 20 |ax for A|EBuild, |
|00001a30| 0d 77 69 74 68 20 61 20 | 66 65 77 20 61 64 64 69 |.with a |few addi|
|00001a40| 74 69 6f 6e 73 20 61 6e | 64 20 6d 6f 64 69 66 69 |tions an|d modifi|
|00001a50| 63 61 74 69 6f 6e 73 2e | 0d 0d 28 76 41 45 42 75 |cations.|..(vAEBu|
|00001a60| 69 6c 64 50 61 72 61 6d | 65 74 65 72 73 20 69 73 |ildParam|eters is|
|00001a70| 20 61 6e 61 6c 6f 67 6f | 75 73 20 74 6f 20 76 70 | analogo|us to vp|
|00001a80| 72 69 6e 74 66 3a 20 49 | 6e 73 74 65 61 64 20 6f |rintf: I|nstead o|
|00001a90| 66 20 70 61 73 73 69 6e | 67 20 74 68 65 20 70 61 |f passin|g the pa|
|00001aa0| 72 61 6d 65 74 65 72 73 | 20 0d 61 6c 6f 6e 67 20 |rameters| .along |
|00001ab0| 77 69 74 68 20 74 68 65 | 20 66 75 6e 63 74 69 6f |with the| functio|
|00001ac0| 6e 2c 20 79 6f 75 20 73 | 75 70 70 6c 79 20 61 20 |n, you s|upply a |
|00001ad0| 76 61 5f 6c 69 73 74 2c | 20 61 73 20 64 65 66 69 |va_list,| as defi|
|00001ae0| 6e 65 64 20 69 6e 20 3c | 73 74 64 61 72 67 2e 68 |ned in <|stdarg.h|
|00001af0| 3e 2c 20 74 68 61 74 20 | 0d 70 6f 69 6e 74 73 20 |>, that |.points |
|00001b00| 74 6f 20 74 68 65 20 70 | 61 72 61 6d 65 74 65 72 |to the p|arameter|
|00001b10| 20 6c 69 73 74 2e 20 49 | 74 d5 73 20 6f 74 68 65 | list. I|t.s othe|
|00001b20| 72 77 69 73 65 20 69 64 | 65 6e 74 69 63 61 6c 2e |rwise id|entical.|
|00001b30| 29 0d 0d 41 45 42 75 69 | 6c 64 41 70 70 6c 65 45 |)..AEBui|ldAppleE|
|00001b40| 76 65 6e 74 0d 0d 41 45 | 42 75 69 6c 64 41 70 70 |vent..AE|BuildApp|
|00001b50| 6c 65 45 76 65 6e 74 28 | 09 41 45 45 76 65 6e 74 |leEvent(|.AEEvent|
|00001b60| 43 6c 61 73 73 20 74 68 | 65 43 6c 61 73 73 2c 20 |Class th|eClass, |
|00001b70| 41 45 45 76 65 6e 74 49 | 44 20 74 68 65 49 44 2c |AEEventI|D theID,|
|00001b80| 0d 09 09 09 09 09 44 65 | 73 63 54 79 70 65 20 61 |......De|scType a|
|00001b90| 64 64 72 65 73 73 54 79 | 70 65 2c 20 76 6f 69 64 |ddressTy|pe, void|
|00001ba0| 20 2a 61 64 64 72 65 73 | 73 44 61 74 61 2c 20 6c | *addres|sData, l|
|00001bb0| 6f 6e 67 20 61 64 64 72 | 65 73 73 4c 65 6e 67 74 |ong addr|essLengt|
|00001bc0| 68 2c 0d 09 09 09 09 09 | 73 68 6f 72 74 20 72 65 |h,......|short re|
|00001bd0| 74 75 72 6e 49 44 2c 20 | 6c 6f 6e 67 20 74 72 61 |turnID, |long tra|
|00001be0| 6e 73 61 63 74 69 6f 6e | 49 44 2c 0d 09 09 09 09 |nsaction|ID,.....|
|00001bf0| 09 41 70 70 6c 65 45 76 | 65 6e 74 20 2a 65 76 65 |.AppleEv|ent *eve|
|00001c00| 6e 74 2c 0d 09 09 09 09 | 09 63 6f 6e 73 74 20 63 |nt,.....|.const c|
|00001c10| 68 61 72 20 2a 64 65 73 | 63 72 69 70 74 6f 72 53 |har *des|criptorS|
|00001c20| 74 72 2c 20 2e 2e 2e 20 | 29 3b 0d 0d 41 45 42 75 |tr, ... |);..AEBu|
|00001c30| 69 6c 64 41 70 70 6c 65 | 45 76 65 6e 74 20 69 73 |ildApple|Event is|
|00001c40| 20 6c 69 6b 65 20 41 45 | 42 75 69 6c 64 20 62 75 | like AE|Build bu|
|00001c50| 74 20 62 75 69 6c 64 73 | 20 61 6e 20 41 70 70 6c |t builds| an Appl|
|00001c60| 65 20 65 76 65 6e 74 2c | 20 69 6e 63 6c 75 64 69 |e event,| includi|
|00001c70| 6e 67 20 0d 70 61 72 61 | 6d 65 74 65 72 73 20 61 |ng .para|meters a|
|00001c80| 6e 64 20 61 74 74 72 69 | 62 75 74 65 73 2e 20 4f |nd attri|butes. O|
|00001c90| 72 2c 20 79 6f 75 20 63 | 6f 75 6c 64 20 73 61 79 |r, you c|ould say|
|00001ca0| 20 74 68 61 74 20 69 74 | d5 73 20 6c 69 6b 65 20 | that it|.s like |
|00001cb0| 41 45 42 75 69 6c 64 50 | 61 72 61 6d 65 74 65 72 |AEBuildP|arameter|
|00001cc0| 73 20 62 75 74 20 0d 63 | 72 65 61 74 65 73 20 74 |s but .c|reates t|
|00001cd0| 68 65 20 65 76 65 6e 74 | 20 66 72 6f 6d 20 73 63 |he event| from sc|
|00001ce0| 72 61 74 63 68 2e 0d 0d | 4d 6f 73 74 20 6f 66 20 |ratch...|Most of |
|00001cf0| 74 68 65 20 70 61 72 61 | 6d 65 74 65 72 73 20 61 |the para|meters a|
|00001d00| 72 65 20 6a 75 73 74 20 | 6c 69 6b 65 20 74 68 65 |re just |like the|
|00001d10| 20 70 61 72 61 6d 65 74 | 65 72 73 20 74 6f 20 41 | paramet|ers to A|
|00001d20| 45 43 72 65 61 74 65 41 | 70 70 6c 65 45 76 65 6e |ECreateA|ppleEven|
|00001d30| 74 2c 20 0d 61 6c 74 68 | 6f 75 67 68 20 79 6f 75 |t, .alth|ough you|
|00001d40| 20 70 61 73 73 20 74 68 | 65 20 74 61 72 67 65 74 | pass th|e target|
|00001d50| 20 61 64 64 72 65 73 73 | 20 64 61 74 61 20 64 69 | address| data di|
|00001d60| 72 65 63 74 6c 79 2c 20 | 69 6e 73 74 65 61 64 20 |rectly, |instead |
|00001d70| 6f 66 20 76 69 61 20 61 | 20 70 72 65 2d 62 75 69 |of via a| pre-bui|
|00001d80| 6c 74 20 0d 64 65 73 63 | 72 69 70 74 6f 72 2e 20 |lt .desc|riptor. |
|00001d90| 54 68 65 20 72 65 73 75 | 6c 74 69 6e 67 20 41 70 |The resu|lting Ap|
|00001da0| 70 6c 65 20 65 76 65 6e | 74 20 77 69 6c 6c 20 61 |ple even|t will a|
|00001db0| 70 70 65 61 72 20 69 6e | 20 74 68 65 20 65 76 65 |ppear in| the eve|
|00001dc0| 6e 74 20 70 61 72 61 6d | 65 74 65 72 2e 0d 64 65 |nt param|eter..de|
|00001dd0| 73 63 72 69 70 74 6f 72 | 53 74 72 20 73 70 65 63 |scriptor|Str spec|
|00001de0| 69 66 69 65 73 20 74 68 | 65 20 70 61 72 61 6d 65 |ifies th|e parame|
|00001df0| 74 65 72 73 20 28 72 65 | 71 75 69 72 65 64 20 61 |ters (re|quired a|
|00001e00| 6e 64 20 6f 70 74 69 6f | 6e 61 6c 29 20 61 6e 64 |nd optio|nal) and|
|00001e10| 20 61 74 74 72 69 62 75 | 74 65 73 2e 20 0d 54 68 | attribu|tes. .Th|
|00001e20| 65 20 73 79 6e 74 61 78 | 20 69 73 20 64 65 73 63 |e syntax| is desc|
|00001e30| 72 69 62 65 64 20 62 65 | 6c 6f 77 20 28 73 65 65 |ribed be|low (see|
|00001e40| 20 65 73 70 65 63 69 61 | 6c 6c 79 20 74 68 65 20 | especia|lly the |
|00001e50| 41 70 70 6c 65 20 45 76 | 65 6e 74 20 44 65 73 63 |Apple Ev|ent Desc|
|00001e60| 72 69 70 74 6f 72 20 53 | 74 72 69 6e 67 73 20 0d |riptor S|trings .|
|00001e70| 73 75 62 73 65 63 74 69 | 6f 6e 29 3b 20 69 74 d5 |subsecti|on); it.|
|00001e80| 73 20 61 6c 6d 6f 73 74 | 20 74 68 65 20 73 61 6d |s almost| the sam|
|00001e90| 65 20 61 73 20 74 68 65 | 20 73 79 6e 74 61 78 20 |e as the| syntax |
|00001ea0| 66 6f 72 20 41 45 42 75 | 69 6c 64 2c 20 77 69 74 |for AEBu|ild, wit|
|00001eb0| 68 20 61 20 66 65 77 20 | 61 64 64 69 74 69 6f 6e |h a few |addition|
|00001ec0| 73 20 0d 61 6e 64 20 6d | 6f 64 69 66 69 63 61 74 |s .and m|odificat|
|00001ed0| 69 6f 6e 73 2e 0d 0d 28 | 76 41 45 42 75 69 6c 64 |ions...(|vAEBuild|
|00001ee0| 41 70 70 6c 65 45 76 65 | 6e 74 20 69 73 20 61 6e |AppleEve|nt is an|
|00001ef0| 61 6c 6f 67 6f 75 73 20 | 74 6f 20 76 70 72 69 6e |alogous |to vprin|
|00001f00| 74 66 3a 20 49 6e 73 74 | 65 61 64 20 6f 66 20 70 |tf: Inst|ead of p|
|00001f10| 61 73 73 69 6e 67 20 74 | 68 65 20 70 61 72 61 6d |assing t|he param|
|00001f20| 65 74 65 72 73 20 0d 61 | 6c 6f 6e 67 20 77 69 74 |eters .a|long wit|
|00001f30| 68 20 74 68 65 20 66 75 | 6e 63 74 69 6f 6e 2c 20 |h the fu|nction, |
|00001f40| 79 6f 75 20 73 75 70 70 | 6c 79 20 61 20 76 61 5f |you supp|ly a va_|
|00001f50| 6c 69 73 74 2c 20 61 73 | 20 64 65 66 69 6e 65 64 |list, as| defined|
|00001f60| 20 69 6e 20 3c 73 74 64 | 61 72 67 2e 68 3e 2c 20 | in <std|arg.h>, |
|00001f70| 74 68 61 74 20 0d 70 6f | 69 6e 74 73 20 74 6f 20 |that .po|ints to |
|00001f80| 74 68 65 20 70 61 72 61 | 6d 65 74 65 72 20 6c 69 |the para|meter li|
|00001f90| 73 74 2e 20 49 74 d5 73 | 20 6f 74 68 65 72 77 69 |st. It.s| otherwi|
|00001fa0| 73 65 20 69 64 65 6e 74 | 69 63 61 6c 2e 29 0d 0d |se ident|ical.)..|
|00001fb0| 41 45 50 72 69 6e 74 0d | 0d 4f 53 45 72 72 20 41 |AEPrint.|.OSErr A|
|00001fc0| 45 50 72 69 6e 74 28 20 | 41 45 44 65 73 63 20 2a |EPrint( |AEDesc *|
|00001fd0| 64 65 73 63 2c 20 63 68 | 61 72 20 2a 62 75 66 53 |desc, ch|ar *bufS|
|00001fe0| 74 72 2c 20 6c 6f 6e 67 | 20 62 75 66 53 69 7a 65 |tr, long| bufSize|
|00001ff0| 20 29 3b 0d 0d 41 45 50 | 72 69 6e 74 20 72 65 61 | );..AEP|rint rea|
|00002000| 64 73 20 74 68 65 20 41 | 70 70 6c 65 20 65 76 65 |ds the A|pple eve|
|00002010| 6e 74 20 64 65 73 63 72 | 69 70 74 6f 72 20 64 65 |nt descr|iptor de|
|00002020| 73 63 20 61 6e 64 20 77 | 72 69 74 65 73 20 61 20 |sc and w|rites a |
|00002030| 63 6f 72 72 65 73 70 6f | 6e 64 69 6e 67 20 0d 64 |correspo|nding .d|
|00002040| 65 73 63 72 69 70 74 6f | 72 20 73 74 72 69 6e 67 |escripto|r string|
|00002050| 20 69 6e 74 6f 20 74 68 | 65 20 73 74 72 69 6e 67 | into th|e string|
|00002060| 20 70 6f 69 6e 74 65 64 | 20 74 6f 20 62 79 20 62 | pointed| to by b|
|00002070| 75 66 53 74 72 2e 20 49 | 74 20 77 69 6c 6c 20 77 |ufStr. I|t will w|
|00002080| 72 69 74 65 20 6e 6f 20 | 6d 6f 72 65 20 74 68 61 |rite no |more tha|
|00002090| 6e 20 0d 62 75 66 53 69 | 7a 65 20 63 68 61 72 61 |n .bufSi|ze chara|
|000020a0| 63 74 65 72 73 2c 20 69 | 6e 63 6c 75 64 69 6e 67 |cters, i|ncluding|
|000020b0| 20 74 68 65 20 74 72 61 | 69 6c 69 6e 67 20 6e 75 | the tra|iling nu|
|000020c0| 6c 6c 20 63 68 61 72 61 | 63 74 65 72 2e 20 41 6e |ll chara|cter. An|
|000020d0| 79 20 65 72 72 6f 72 73 | 20 72 65 74 75 72 6e 65 |y errors| returne|
|000020e0| 64 20 62 79 20 0d 41 70 | 70 6c 65 20 45 76 65 6e |d by .Ap|ple Even|
|000020f0| 74 20 4d 61 6e 61 67 65 | 72 20 72 6f 75 74 69 6e |t Manage|r routin|
|00002100| 65 73 20 77 69 6c 6c 20 | 62 65 20 72 65 74 75 72 |es will |be retur|
|00002110| 6e 65 64 20 74 6f 20 74 | 68 65 20 63 61 6c 6c 65 |ned to t|he calle|
|00002120| 72 3b 20 74 68 69 73 20 | 69 73 6e d5 74 20 76 65 |r; this |isn.t ve|
|00002130| 72 79 20 6c 69 6b 65 6c | 79 20 0d 75 6e 6c 65 73 |ry likel|y .unles|
|00002140| 73 20 74 68 65 20 41 45 | 44 65 73 63 20 73 74 72 |s the AE|Desc str|
|00002150| 75 63 74 75 72 65 20 69 | 73 20 73 6f 6d 65 68 6f |ucture i|s someho|
|00002160| 77 20 63 6f 72 72 75 70 | 74 2e 0d 0d 54 68 65 20 |w corrup|t...The |
|00002170| 64 65 73 63 72 69 70 74 | 6f 72 20 73 74 72 69 6e |descript|or strin|
|00002180| 67 20 70 72 6f 64 75 63 | 65 64 2c 20 69 66 20 73 |g produc|ed, if s|
|00002190| 65 6e 74 20 74 6f 20 41 | 45 42 75 69 6c 64 2c 20 |ent to A|EBuild, |
|000021a0| 77 69 6c 6c 20 62 75 69 | 6c 64 20 61 20 64 65 73 |will bui|ld a des|
|000021b0| 63 72 69 70 74 6f 72 20 | 0d 69 64 65 6e 74 69 63 |criptor |.identic|
|000021c0| 61 6c 20 74 6f 20 74 68 | 65 20 6f 72 69 67 69 6e |al to th|e origin|
|000021d0| 61 6c 20 6f 6e 65 2e 20 | 41 45 50 72 69 6e 74 20 |al one. |AEPrint |
|000021e0| 74 72 69 65 73 20 74 6f | 20 64 65 74 65 63 74 20 |tries to| detect |
|000021f0| 41 45 52 65 63 6f 72 64 | 73 20 74 68 61 74 20 68 |AERecord|s that h|
|00002200| 61 76 65 20 62 65 65 6e | 20 0d 63 6f 65 72 63 65 |ave been| .coerce|
|00002210| 64 20 74 6f 20 6f 74 68 | 65 72 20 74 79 70 65 73 |d to oth|er types|
|00002220| 20 61 6e 64 20 70 72 69 | 6e 74 20 74 68 65 6d 20 | and pri|nt them |
|00002230| 61 73 20 63 6f 65 72 63 | 65 64 20 72 65 63 6f 72 |as coerc|ed recor|
|00002240| 64 73 2e 20 53 74 72 75 | 63 74 75 72 65 73 20 6f |ds. Stru|ctures o|
|00002250| 66 20 75 6e 6b 6e 6f 77 | 6e 20 0d 74 79 70 65 20 |f unknow|n .type |
|00002260| 74 68 61 74 20 63 61 6e | d5 74 20 62 65 20 63 6f |that can|.t be co|
|00002270| 65 72 63 65 64 20 74 6f | 20 41 45 52 65 63 6f 72 |erced to| AERecor|
|00002280| 64 73 20 61 72 65 20 64 | 75 6d 70 65 64 20 61 73 |ds are d|umped as|
|00002290| 20 68 65 78 20 64 61 74 | 61 2e 0d 0d 41 45 50 72 | hex dat|a...AEPr|
|000022a0| 69 6e 74 20 63 61 6e 20 | 61 6c 73 6f 20 70 72 69 |int can |also pri|
|000022b0| 6e 74 20 63 6f 6d 70 6c | 65 74 65 20 41 70 70 6c |nt compl|ete Appl|
|000022c0| 65 20 65 76 65 6e 74 73 | 20 61 73 20 77 65 6c 6c |e events| as well|
|000022d0| 20 61 73 20 72 65 67 75 | 6c 61 72 20 64 65 73 63 | as regu|lar desc|
|000022e0| 72 69 70 74 6f 72 73 2e | 20 54 68 65 20 0d 73 79 |riptors.| The .sy|
|000022f0| 6e 74 61 78 20 6f 66 20 | 74 68 65 20 72 65 73 75 |ntax of |the resu|
|00002300| 6c 74 69 6e 67 20 73 74 | 72 69 6e 67 20 66 6f 72 |lting st|ring for|
|00002310| 20 61 6e 20 65 76 65 6e | 74 20 69 73 20 6c 69 6b | an even|t is lik|
|00002320| 65 20 74 68 61 74 20 75 | 73 65 64 20 62 79 20 41 |e that u|sed by A|
|00002330| 45 42 75 69 6c 64 50 61 | 72 61 6d 65 74 65 72 73 |EBuildPa|rameters|
|00002340| 20 0d 61 6e 64 20 41 45 | 42 75 69 6c 64 41 70 70 | .and AE|BuildApp|
|00002350| 6c 65 45 76 65 6e 74 2c | 20 65 78 63 65 70 74 20 |leEvent,| except |
|00002360| 74 68 61 74 3a 0d 0d a5 | 09 54 68 65 20 73 74 72 |that:...|.The str|
|00002370| 69 6e 67 20 62 65 67 69 | 6e 73 20 77 69 74 68 20 |ing begi|ns with |
|00002380| 74 68 65 20 65 76 65 6e | 74 20 63 6c 61 73 73 20 |the even|t class |
|00002390| 61 6e 64 20 49 44 20 73 | 65 70 61 72 61 74 65 64 |and ID s|eparated|
|000023a0| 20 62 79 20 61 20 62 61 | 63 6b 73 6c 61 73 68 2e | by a ba|ckslash.|
|000023b0| 0d a5 09 74 68 65 20 70 | 61 72 61 6d 65 74 65 72 |...the p|arameter|
|000023c0| 20 6c 69 73 74 20 69 73 | 20 73 75 72 72 6f 75 6e | list is| surroun|
|000023d0| 64 65 64 20 62 79 20 63 | 75 72 6c 79 20 62 72 61 |ded by c|urly bra|
|000023e0| 63 65 73 2e 0d a5 09 41 | 74 74 72 69 62 75 74 65 |ces....A|ttribute|
|000023f0| 73 20 61 72 65 20 61 6c | 73 6f 20 64 69 73 70 6c |s are al|so displ|
|00002400| 61 79 65 64 3b 20 74 68 | 65 79 20 6c 6f 6f 6b 20 |ayed; th|ey look |
|00002410| 6c 69 6b 65 20 70 61 72 | 61 6d 65 74 65 72 73 20 |like par|ameters |
|00002420| 62 75 74 20 61 72 65 20 | 70 72 65 63 65 64 65 64 |but are |preceded|
|00002430| 20 62 79 20 0d 09 d2 26 | d3 73 2e 0d 0d 20 09 54 | by ...&|.s... .T|
|00002440| 68 65 20 62 75 69 6c 64 | 65 72 20 66 75 6e 63 74 |he build|er funct|
|00002450| 69 6f 6e 73 20 64 6f 20 | 6e 6f 74 20 61 63 63 65 |ions do |not acce|
|00002460| 70 74 20 74 68 69 73 20 | 65 76 65 6e 74 20 73 79 |pt this |event sy|
|00002470| 6e 74 61 78 20 79 65 74 | 2e ca ca 0d 0d 41 45 50 |ntax yet|.....AEP|
|00002480| 72 69 6e 74 53 69 7a 65 | 0d 0d 4f 53 45 72 72 20 |rintSize|..OSErr |
|00002490| 41 45 50 72 69 6e 74 53 | 69 7a 65 28 20 41 45 44 |AEPrintS|ize( AED|
|000024a0| 65 73 63 20 2a 64 65 73 | 63 2c 20 6c 6f 6e 67 20 |esc *des|c, long |
|000024b0| 2a 62 75 66 53 69 7a 65 | 4e 65 65 64 65 64 20 29 |*bufSize|Needed )|
|000024c0| 3b 0d 0d 41 45 50 72 69 | 6e 74 53 69 7a 65 20 63 |;..AEPri|ntSize c|
|000024d0| 6f 6d 70 75 74 65 73 20 | 74 68 65 20 62 75 66 66 |omputes |the buff|
|000024e0| 65 72 20 73 69 7a 65 20 | 74 68 61 74 20 41 45 50 |er size |that AEP|
|000024f0| 72 69 6e 74 20 77 6f 75 | 6c 64 20 72 65 71 75 69 |rint wou|ld requi|
|00002500| 72 65 20 69 66 20 67 69 | 76 65 6e 20 74 68 65 20 |re if gi|ven the |
|00002510| 0d 73 61 6d 65 20 64 65 | 73 63 72 69 70 74 6f 72 |.same de|scriptor|
|00002520| 2e 20 28 54 68 65 20 73 | 69 7a 65 20 69 73 20 65 |. (The s|ize is e|
|00002530| 71 75 61 6c 20 74 6f 20 | 74 68 65 20 73 74 72 69 |qual to |the stri|
|00002540| 6e 67 20 6c 65 6e 67 74 | 68 2c 20 70 6c 75 73 20 |ng lengt|h, plus |
|00002550| 31 20 62 79 74 65 20 66 | 6f 72 20 74 68 65 20 74 |1 byte f|or the t|
|00002560| 72 61 69 6c 69 6e 67 20 | 0d 6e 75 6c 6c 2e 29 20 |railing |.null.) |
|00002570| 54 68 69 73 20 69 73 20 | 68 61 6e 64 79 20 66 6f |This is |handy fo|
|00002580| 72 20 70 72 65 2d 66 6c | 69 67 68 74 69 6e 67 20 |r pre-fl|ighting |
|00002590| 41 45 50 72 69 6e 74 2c | 20 69 66 20 79 6f 75 20 |AEPrint,| if you |
|000025a0| 77 61 6e 74 20 74 6f 20 | 61 6c 6c 6f 63 61 74 65 |want to |allocate|
|000025b0| 20 74 68 65 20 62 75 66 | 66 65 72 20 0d 64 79 6e | the buf|fer .dyn|
|000025c0| 61 6d 69 63 61 6c 6c 79 | 20 20 69 6e 73 74 65 61 |amically|  instea|
|000025d0| 64 20 6f 66 20 72 65 6c | 79 69 6e 67 20 6f 6e 20 |d of rel|ying on |
|000025e0| 6f 6e 65 20 6f 66 20 66 | 69 78 65 64 20 73 69 7a |one of f|ixed siz|
|000025f0| 65 20 2e 0d 0d 44 65 73 | 63 72 69 70 74 6f 72 2d |e ...Des|criptor-|
|00002600| 53 74 72 69 6e 67 20 53 | 79 6e 74 61 78 0d 2d 2d |String S|yntax.--|
|00002610| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00002620| 2d 2d 2d 2d 2d 2d 0d 0d | 54 68 65 20 72 65 61 6c |------..|The real|
|00002630| 20 6d 65 61 74 20 6f 66 | 20 61 6c 6c 20 74 68 69 | meat of| all thi|
|00002640| 73 2c 20 6f 66 20 63 6f | 75 72 73 65 2c 20 69 73 |s, of co|urse, is|
|00002650| 20 74 68 65 20 73 79 6e | 74 61 78 20 6f 66 20 74 | the syn|tax of t|
|00002660| 68 65 20 64 65 73 63 72 | 69 70 74 6f 72 20 73 74 |he descr|iptor st|
|00002670| 72 69 6e 67 73 2e 20 49 | 74 d5 73 20 0d 70 72 65 |rings. I|t.s .pre|
|00002680| 74 74 79 20 73 69 6d 70 | 6c 65 3a 20 62 61 73 69 |tty simp|le: basi|
|00002690| 63 20 64 61 74 61 20 74 | 79 70 65 73 20 6c 69 6b |c data t|ypes lik|
|000026a0| 65 20 6e 75 6d 62 65 72 | 73 20 61 6e 64 20 73 74 |e number|s and st|
|000026b0| 72 69 6e 67 73 20 63 61 | 6e 20 62 65 20 64 65 73 |rings ca|n be des|
|000026c0| 63 72 69 62 65 64 20 0d | 64 69 72 65 63 74 6c 79 |cribed .|directly|
|000026d0| 2c 20 61 6e 64 20 74 68 | 65 6e 20 62 75 69 6c 74 |, and th|en built|
|000026e0| 20 75 70 20 69 6e 74 6f | 20 6c 69 73 74 73 20 61 | up into| lists a|
|000026f0| 6e 64 20 72 65 63 6f 72 | 64 73 2e 20 49 d5 76 65 |nd recor|ds. I.ve|
|00002700| 20 65 76 65 6e 20 70 72 | 6f 76 69 64 65 64 20 61 | even pr|ovided a|
|00002710| 20 70 73 65 75 64 6f 2d | 0d 42 4e 46 20 67 72 61 | pseudo-|.BNF gra|
|00002720| 6d 6d 61 72 20 28 6e 65 | 78 74 20 73 65 63 74 69 |mmar (ne|xt secti|
|00002730| 6f 6e 29 20 66 6f 72 20 | 74 68 6f 73 65 20 6f 66 |on) for |those of|
|00002740| 20 79 6f 75 20 77 68 6f | 20 61 63 74 75 61 6c 6c | you who| actuall|
|00002750| 79 20 65 6e 6a 6f 79 20 | 72 65 61 64 69 6e 67 20 |y enjoy |reading |
|00002760| 74 68 6f 73 65 20 74 68 | 69 6e 67 73 2e 0d 0d 42 |those th|ings...B|
|00002770| 61 73 69 63 20 54 79 70 | 65 73 0d 0d 54 68 65 20 |asic Typ|es..The |
|00002780| 66 75 6e 64 61 6d 65 6e | 74 61 6c 20 64 61 74 61 |fundamen|tal data|
|00002790| 20 74 79 70 65 73 20 61 | 72 65 3a 0d 0d 54 79 70 | types a|re:..Typ|
|000027a0| 65 20 20 20 20 20 20 20 | 20 20 20 20 20 45 78 61 |e       |     Exa|
|000027b0| 6d 70 6c 65 73 20 20 20 | 20 20 20 20 20 54 79 70 |mples   |     Typ|
|000027c0| 65 2d 63 6f 64 65 20 20 | 20 20 20 20 20 44 65 73 |e-code  |     Des|
|000027d0| 63 72 69 70 74 69 6f 6e | 0d 2d 2d 2d 2d 20 20 20 |cription|.----   |
|000027e0| 20 20 20 20 20 20 20 20 | 20 2d 2d 2d 2d 2d 2d 2d |        | -------|
|000027f0| 2d 20 20 20 20 20 20 20 | 20 2d 2d 2d 2d 2d 2d 2d |-       | -------|
|00002800| 2d 2d 20 20 20 20 20 20 | 20 2d 2d 2d 2d 2d 2d 2d |--      | -------|
|00002810| 2d 2d 2d 2d 0d 49 6e 74 | 65 67 65 72 20 20 20 20 |----.Int|eger    |
|00002820| 20 20 20 20 20 31 32 33 | 34 20 20 20 20 20 20 20 |     123|4       |
|00002830| 20 20 20 20 20 27 6c 6f | 6e 67 27 20 6f 72 20 20 |     'lo|ng' or  |
|00002840| 20 20 20 20 20 41 20 73 | 65 71 75 65 6e 63 65 20 |     A s|equence |
|00002850| 6f 66 20 64 65 63 69 6d | 61 6c 20 64 69 67 69 74 |of decim|al digit|
|00002860| 73 2c 0d 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |s,.     |        |
|00002870| 20 20 20 2d 35 36 37 38 | 20 20 20 20 20 20 20 20 |   -5678|        |
|00002880| 20 20 20 27 73 68 6f 72 | 27 20 20 20 20 20 20 20 |   'shor|'       |
|00002890| 20 20 20 6f 70 74 69 6f | 6e 61 6c 6c 79 20 70 72 |   optio|nally pr|
|000028a0| 65 63 65 64 65 64 20 62 | 79 20 61 20 6d 69 6e 75 |eceded b|y a minu|
|000028b0| 73 0d 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |s.      |        |
|000028c0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|000028d0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|000028e0| 20 20 73 69 67 6e 2e 0d | 0d 45 6e 75 6d 2f 54 79 |  sign..|.Enum/Ty|
|000028f0| 70 65 20 20 20 20 20 20 | 20 77 68 6f 73 20 20 20 |pe      | whos   |
|00002900| 20 20 20 20 20 20 20 20 | 20 27 65 6e 75 6d 27 20 |        | 'enum' |
|00002910| 20 20 20 20 20 20 20 20 | 20 41 20 6d 61 67 69 63 |        | A magic|
|00002920| 20 66 6f 75 72 2d 6c 65 | 74 74 65 72 20 63 6f 64 | four-le|tter cod|
|00002930| 65 2e 20 57 69 6c 6c 20 | 62 65 0d 43 6f 64 65 20 |e. Will |be.Code |
|00002940| 20 20 20 20 20 20 20 20 | 20 20 20 6c 6f 6e 67 69 |        |   longi|
|00002950| 6e 74 20 20 20 20 20 20 | 20 20 20 28 55 73 65 20 |nt      |   (Use |
|00002960| 63 6f 65 72 63 69 6f 6e | 20 20 20 74 72 75 6e 63 |coercion|   trunc|
|00002970| 61 74 65 64 20 6f 72 20 | 70 61 64 64 65 64 20 77 |ated or |padded w|
|00002980| 69 74 68 20 73 70 61 63 | 65 73 0d 20 20 20 20 20 |ith spac|es.     |
|00002990| 20 20 20 20 20 20 20 20 | 20 20 20 27 6c 6f 6e 67 |        |   'long|
|000029a0| 27 20 20 20 20 20 20 20 | 20 20 20 74 6f 20 63 68 |'       |   to ch|
|000029b0| 61 6e 67 65 20 74 6f 20 | 20 20 20 74 6f 20 65 78 |ange to |   to ex|
|000029c0| 61 63 74 6c 79 20 66 6f | 75 72 20 63 68 61 72 61 |actly fo|ur chara|
|000029d0| 63 74 65 72 73 2e 20 49 | 66 20 79 6f 75 0d 20 20 |cters. I|f you.  |
|000029e0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 3c 3d |        |      <=|
|000029f0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 27 74 |        |      't|
|00002a00| 79 70 65 27 29 20 20 20 | 20 20 20 20 20 20 70 75 |ype')   |      pu|
|00002a10| 74 20 73 74 72 61 69 67 | 68 74 20 6f 72 20 63 75 |t straig|ht or cu|
|00002a20| 72 6c 79 20 73 69 6e 67 | 6c 65 2d 0d 20 20 20 20 |rly sing|le-.    |
|00002a30| 20 20 20 20 20 20 20 20 | 20 20 20 20 27 38 2d 29 |        |    '8-)|
|00002a40| 27 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |'       |        |
|00002a50| 20 20 20 20 20 20 20 20 | 20 20 20 20 71 75 6f 74 |        |    quot|
|00002a60| 65 73 20 61 72 6f 75 6e | 64 20 69 74 2c 20 69 74 |es aroun|d it, it|
|00002a70| 20 63 61 6e 20 63 6f 6e | 74 61 69 6e 0d 20 20 20 | can con|tain.   |
|00002a80| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 d4 5a 51 |        |     .ZQ|
|00002a90| 20 35 d5 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | 5.     |        |
|00002aa0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 61 6e 79 |        |     any|
|00002ab0| 20 63 68 61 72 61 63 74 | 65 72 73 2e 20 49 66 20 | charact|ers. If |
|00002ac0| 6e 6f 74 2c 20 69 74 20 | 63 61 6e d5 74 0d 20 20 |not, it |can.t.  |
|00002ad0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 6d 20 |        |      m |
|00002ae0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00002af0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 63 6f |        |      co|
|00002b00| 6e 74 61 69 6e 20 61 6e | 79 20 6f 66 3a 20 40 d4 |ntain an|y of: @.|
|00002b10| 27 d2 d3 3a 2d 2c 28 5b | 7b 7d 5d 29 0d 20 20 20 |'..:-,([|{}]).   |
|00002b20| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00002b30| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00002b40| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 61 6e 64 |        |     and|
|00002b50| 20 63 61 6e d5 74 20 62 | 65 67 69 6e 20 77 69 74 | can.t b|egin wit|
|00002b60| 68 20 61 20 64 69 67 69 | 74 2e 0d 0d 53 74 72 69 |h a digi|t...Stri|
|00002b70| 6e 67 20 20 20 20 20 20 | d2 41 20 53 74 72 69 6e |ng      |.A Strin|
|00002b80| 67 2e d3 20 20 20 20 20 | 20 20 20 20 27 54 45 58 |g..     |    'TEX|
|00002b90| 54 27 20 20 20 20 20 20 | 20 20 20 20 41 6e 79 20 |T'      |    Any |
|00002ba0| 73 65 71 75 65 6e 63 65 | 20 6f 66 20 63 68 61 72 |sequence| of char|
|00002bb0| 61 63 74 65 72 73 0d 20 | 20 20 20 20 20 20 20 20 |acters. |        |
|00002bc0| 20 20 20 d2 4d 75 6c 74 | 69 70 6c 65 20 6c 69 6e |   .Mult|iple lin|
|00002bd0| 65 73 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |es      |        |
|00002be0| 20 20 20 20 20 20 20 77 | 69 74 68 69 6e 20 6f 70 |       w|ithin op|
|00002bf0| 65 6e 20 61 6e 64 20 63 | 6c 6f 73 65 20 63 75 72 |en and c|lose cur|
|00002c00| 6c 79 0d 20 20 20 20 20 | 20 20 20 20 20 20 20 61 |ly.     |       a|
|00002c10| 72 65 20 6f 6b 61 79 2e | d3 20 20 20 20 20 20 20 |re okay.|.       |
|00002c20| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00002c30| 20 20 20 71 75 6f 74 65 | 73 2e 20 57 6f 6e d5 74 |   quote|s. Won.t|
|00002c40| 20 62 65 20 6e 75 6c 6c | 2d 74 65 72 6d 69 6e 61 | be null|-termina|
|00002c50| 74 65 64 2e 0d 0d 48 65 | 78 20 44 61 74 61 20 20 |ted...He|x Data  |
|00002c60| 20 20 c7 34 31 37 30 37 | 30 36 43 36 35 c8 20 20 |  .41707|06C65.  |
|00002c70| 20 20 20 20 20 20 3f 3f | 20 20 20 20 20 20 20 20 |      ??|        |
|00002c80| 20 20 20 20 20 20 41 6e | 20 65 76 65 6e 20 6e 75 |      An| even nu|
|00002c90| 6d 62 65 72 20 6f 66 20 | 68 65 78 20 64 69 67 69 |mber of |hex digi|
|00002ca0| 74 73 0d 20 20 20 20 20 | 20 20 20 20 20 20 20 c7 |ts.     |       .|
|00002cb0| 30 31 30 32 20 30 33 66 | 66 20 20 20 20 20 20 20 |0102 03f|f       |
|00002cc0| 20 20 20 28 4d 75 73 74 | 20 62 65 20 20 20 20 20 |   (Must| be     |
|00002cd0| 20 20 20 62 65 74 77 65 | 65 6e 20 46 72 65 6e 63 |   betwe|en Frenc|
|00002ce0| 68 20 71 75 6f 74 65 73 | 20 28 4f 70 74 69 6f 6e |h quotes| (Option|
|00002cf0| 2d 0d 20 20 20 20 20 20 | 20 20 20 20 20 20 20 65 |-.      |       e|
|00002d00| 20 62 20 36 20 63 c8 20 | 20 20 20 20 20 20 20 20 | b 6 c. |        |
|00002d10| 20 20 63 6f 65 72 63 65 | 64 20 74 6f 20 20 20 20 |  coerce|d to    |
|00002d20| 20 20 5c 2c 20 4f 70 74 | 69 6f 6e 2d 53 68 69 66 |  \, Opt|ion-Shif|
|00002d30| 74 2d 5c 29 2e 20 57 68 | 69 74 65 73 70 61 63 65 |t-\). Wh|itespace|
|00002d40| 20 69 73 0d 20 20 20 20 | 20 20 20 20 20 20 20 20 | is.    |        |
|00002d50| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00002d60| 20 20 20 20 73 6f 6d 65 | 20 74 79 70 65 29 20 20 |    some| type)  |
|00002d70| 20 20 20 20 69 67 6e 6f | 72 65 64 2e 0d 0d 20 59 |    igno|red... Y|
|00002d80| 65 73 2c 20 79 6f 75 20 | 68 61 76 65 20 74 6f 20 |es, you |have to |
|00002d90| 75 73 65 20 74 68 65 20 | 61 63 74 75 61 6c 20 66 |use the |actual f|
|00002da0| 6f 75 72 2d 6c 65 74 74 | 65 72 20 63 6f 64 65 73 |our-lett|er codes|
|00002db0| 20 66 6f 72 20 65 6e 75 | 6d 73 2c 20 74 79 70 65 | for enu|ms, type|
|00002dc0| 20 63 6f 64 65 73 2c 20 | 6b 65 79 77 6f 72 64 73 | codes, |keywords|
|00002dd0| 20 0d 61 6e 64 20 6f 62 | 6a 65 63 74 20 74 79 70 | .and ob|ject typ|
|00002de0| 65 73 2c 20 69 6e 73 74 | 65 61 64 20 6f 66 20 74 |es, inst|ead of t|
|00002df0| 68 65 20 6d 6e 65 6d 6f | 6e 69 63 20 63 6f 6e 73 |he mnemo|nic cons|
|00002e00| 74 61 6e 74 73 2e 20 20 | 4c 75 63 6b 69 6c 79 20 |tants.  |Luckily |
|00002e10| 74 68 65 20 63 6f 64 65 | 73 20 61 72 65 20 0d 73 |the code|s are .s|
|00002e20| 65 6d 69 2d 6d 6e 65 6d | 6f 6e 69 63 20 61 6e 79 |emi-mnem|onic any|
|00002e30| 77 61 79 2e 20 20 49 20 | 64 69 64 20 69 74 20 74 |way.  I |did it t|
|00002e40| 68 69 73 20 77 61 79 20 | 74 6f 20 61 76 6f 69 64 |his way |to avoid|
|00002e50| 20 74 68 65 20 6d 61 73 | 73 69 76 65 20 6f 76 65 | the mas|sive ove|
|00002e60| 72 68 65 61 64 2c 20 62 | 6f 74 68 20 69 6e 20 63 |rhead, b|oth in c|
|00002e70| 6f 64 65 20 0d 73 69 7a | 65 20 61 6e 64 20 65 78 |ode .siz|e and ex|
|00002e80| 65 63 75 74 69 6f 6e 20 | 73 70 65 65 64 2c 20 6f |ecution |speed, o|
|00002e90| 66 20 61 20 73 79 6d 62 | 6f 6c 20 74 61 62 6c 65 |f a symb|ol table|
|00002ea0| 2e 20 20 59 6f 75 20 63 | 61 6e 20 66 69 6e 64 20 |.  You c|an find |
|00002eb0| 74 68 65 20 64 65 66 69 | 6e 69 74 69 6f 6e 73 20 |the defi|nitions |
|00002ec0| 6f 66 20 74 68 65 20 0d | 63 6f 6e 73 74 61 6e 74 |of the .|constant|
|00002ed0| 73 20 69 6e 20 74 68 65 | 20 74 65 78 74 20 66 69 |s in the| text fi|
|00002ee0| 6c 65 20 d2 41 45 4f 62 | 6a 65 63 74 73 2e 70 d3 |le .AEOb|jects.p.|
|00002ef0| 2c 20 77 68 69 63 68 20 | 69 73 20 70 61 72 74 20 |, which |is part |
|00002f00| 6f 66 20 74 68 65 20 41 | 70 70 6c 65 20 45 76 65 |of the A|pple Eve|
|00002f10| 6e 74 73 20 4f 62 6a 65 | 63 74 20 0d 53 75 70 70 |nts Obje|ct .Supp|
|00002f20| 6f 72 74 20 4c 69 62 72 | 61 72 79 2e ca ca 0d 0d |ort Libr|ary.....|
|00002f30| 43 6f 65 72 63 69 6f 6e | 0d 0d 41 6e 79 20 62 61 |Coercion|..Any ba|
|00002f40| 73 69 63 20 65 6c 65 6d | 65 6e 74 20 28 65 78 63 |sic elem|ent (exc|
|00002f50| 65 70 74 20 61 20 68 65 | 78 20 73 74 72 69 6e 67 |ept a he|x string|
|00002f60| 29 20 62 79 20 69 74 73 | 65 6c 66 20 69 73 20 61 |) by its|elf is a|
|00002f70| 20 64 65 73 63 72 69 70 | 74 6f 72 2c 20 77 68 6f | descrip|tor, who|
|00002f80| 73 65 20 0d 64 65 73 63 | 72 69 70 74 6f 72 54 79 |se .desc|riptorTy|
|00002f90| 70 65 20 69 73 20 61 73 | 20 67 69 76 65 6e 20 69 |pe is as| given i|
|00002fa0| 6e 20 74 68 65 20 74 61 | 62 6c 65 2e 20 59 6f 75 |n the ta|ble. You|
|00002fb0| 20 63 61 6e 20 63 6f 65 | 72 63 65 20 61 20 62 61 | can coe|rce a ba|
|00002fc0| 73 69 63 20 65 6c 65 6d | 65 6e 74 20 74 6f 20 61 |sic elem|ent to a|
|00002fd0| 20 0d 64 69 66 66 65 72 | 65 6e 74 20 74 79 70 65 | .differ|ent type|
|00002fe0| 20 62 79 20 70 75 74 74 | 69 6e 67 20 69 74 20 69 | by putt|ing it i|
|00002ff0| 6e 20 70 61 72 65 6e 74 | 68 65 73 65 73 20 77 69 |n parent|heses wi|
|00003000| 74 68 20 61 20 74 79 70 | 65 2d 63 6f 64 65 20 70 |th a typ|e-code p|
|00003010| 6c 61 63 65 64 20 62 65 | 66 6f 72 65 20 69 74 2e |laced be|fore it.|
|00003020| 20 48 65 72 65 20 0d 61 | 72 65 20 73 6f 6d 65 20 | Here .a|re some |
|00003030| 65 78 61 6d 70 6c 65 73 | 3a 0d 0d 09 73 69 6e 67 |examples|:...sing|
|00003040| 28 31 32 33 34 29 0d 09 | 74 79 70 65 28 6c 69 6e |(1234)..|type(lin|
|00003050| 65 29 0d 09 6c 6f 6e 67 | 28 43 4f 44 45 29 0d 09 |e)..long|(CODE)..|
|00003060| 68 65 78 64 28 d2 41 20 | 53 74 72 69 6e 67 d3 29 |hexd(.A |String.)|
|00003070| 0d 09 27 62 6c 6f 62 27 | 28 c7 34 31 37 30 37 30 |..'blob'|(.417070|
|00003080| 36 43 36 35 c8 29 0d 0d | 09 43 6f 65 72 63 69 6f |6C65.)..|.Coercio|
|00003090| 6e 73 20 6f 66 20 6e 75 | 6d 65 72 69 63 20 76 61 |ns of nu|meric va|
|000030a0| 6c 75 65 73 20 61 72 65 | 20 65 66 66 65 63 74 65 |lues are| effecte|
|000030b0| 64 20 62 79 20 63 61 6c | 6c 69 6e 67 20 41 45 43 |d by cal|ling AEC|
|000030c0| 6f 65 72 63 65 44 65 73 | 63 3b 20 69 66 20 74 68 |oerceDes|c; if th|
|000030d0| 65 20 0d 63 6f 65 72 63 | 69 6f 6e 20 66 61 69 6c |e .coerc|ion fail|
|000030e0| 73 2c 20 79 6f 75 d5 6c | 6c 20 67 65 74 20 61 6e |s, you.l|l get an|
|000030f0| 20 65 72 72 41 45 43 6f | 65 72 63 69 6f 6e 46 61 | errAECo|ercionFa|
|00003100| 69 6c 20 65 72 72 6f 72 | 20 72 65 74 75 72 6e 65 |il error| returne|
|00003110| 64 20 74 6f 20 79 6f 75 | 2e 20 0d 43 6f 65 72 63 |d to you|. .Coerc|
|00003120| 69 6f 6e 73 20 6f 66 20 | 6f 74 68 65 72 20 74 79 |ions of |other ty|
|00003130| 70 65 73 20 6a 75 73 74 | 20 72 65 70 6c 61 63 65 |pes just| replace|
|00003140| 20 74 68 65 20 64 65 73 | 63 72 69 70 74 6f 72 54 | the des|criptorT|
|00003150| 79 70 65 20 66 69 65 6c | 64 20 6f 66 20 74 68 65 |ype fiel|d of the|
|00003160| 20 41 45 44 65 73 63 2e | ca ca 0d 0d 09 48 65 78 | AEDesc.|.....Hex|
|00003170| 20 73 74 72 69 6e 67 73 | 20 6d 75 73 74 20 62 65 | strings| must be|
|00003180| 20 63 6f 65 72 63 65 64 | 20 74 6f 20 73 6f 6d 65 | coerced| to some|
|00003190| 74 68 69 6e 67 2c 20 73 | 69 6e 63 65 20 74 68 65 |thing, s|ince the|
|000031a0| 79 20 68 61 76 65 20 6e | 6f 20 69 6e 74 72 69 6e |y have n|o intrin|
|000031b0| 73 69 63 20 74 79 70 65 | 2e ca ca 0d 0d 59 6f 75 |sic type|.....You|
|000031c0| 20 63 61 6e 20 61 6c 73 | 6f 20 63 6f 65 72 63 65 | can als|o coerce|
|000031d0| 20 6e 6f 74 68 69 6e 67 | 2c 20 74 6f 20 67 65 74 | nothing|, to get|
|000031e0| 20 61 20 64 65 73 63 72 | 69 70 74 6f 72 20 77 69 | a descr|iptor wi|
|000031f0| 74 68 20 7a 65 72 6f 2d | 6c 65 6e 67 74 68 20 64 |th zero-|length d|
|00003200| 61 74 61 3a 0d 0d 09 65 | 6d 74 79 28 29 0d 0d 45 |ata:...e|mty()..E|
|00003210| 76 65 6e 20 74 68 65 20 | 74 79 70 65 20 63 61 6e |ven the |type can|
|00003220| 20 62 65 20 6f 6d 69 74 | 74 65 64 2c 20 6c 65 61 | be omit|ted, lea|
|00003230| 76 69 6e 67 20 6a 75 73 | 74 20 28 29 2c 20 69 6e |ving jus|t (), in|
|00003240| 20 77 68 69 63 68 20 63 | 61 73 65 20 74 68 65 20 | which c|ase the |
|00003250| 74 79 70 65 20 69 73 20 | 27 6e 75 6c 6c 27 2e 0d |type is |'null'..|
|00003260| 0d 4c 69 73 74 73 0d 0d | 54 6f 20 6d 61 6b 65 20 |.Lists..|To make |
|00003270| 61 6e 20 41 45 44 65 73 | 63 4c 69 73 74 2c 20 6a |an AEDes|cList, j|
|00003280| 75 73 74 20 65 6e 63 6c | 6f 73 65 20 61 20 63 6f |ust encl|ose a co|
|00003290| 6d 6d 61 2d 73 65 70 61 | 72 61 74 65 64 20 6c 69 |mma-sepa|rated li|
|000032a0| 73 74 20 6f 66 20 64 65 | 73 63 72 69 70 74 6f 72 |st of de|scriptor|
|000032b0| 73 20 69 6e 20 0d 73 71 | 75 61 72 65 20 62 72 61 |s in .sq|uare bra|
|000032c0| 63 6b 65 74 73 2e 20 46 | 6f 72 20 65 78 61 6d 70 |ckets. F|or examp|
|000032d0| 6c 65 3a 0d 0d 09 5b 31 | 32 33 2c 20 2d 34 35 36 |le:...[1|23, -456|
|000032e0| 2c 20 d2 65 74 20 63 65 | 74 65 72 61 d3 5d 0d 09 |, .et ce|tera.]..|
|000032f0| 5b 73 69 6e 67 28 31 32 | 33 34 29 2c 20 6c 6f 6e |[sing(12|34), lon|
|00003300| 67 28 43 4f 44 45 29 2c | 0d 09 20 5b d2 77 68 65 |g(CODE),|.. [.whe|
|00003310| 65 6c 73 d3 2c 20 d2 77 | 69 74 68 69 6e 20 77 68 |els., .w|ithin wh|
|00003320| 65 65 6c 73 d3 5d 5d 0d | 09 5b 5d 0d 0d 54 68 65 |eels.]].|.[]..The|
|00003330| 20 65 6c 65 6d 65 6e 74 | 73 20 6f 66 20 61 20 6c | element|s of a l|
|00003340| 69 73 74 20 63 61 6e 20 | 62 65 20 6f 66 20 64 69 |ist can |be of di|
|00003350| 66 66 65 72 65 6e 74 20 | 74 79 70 65 73 2c 20 61 |fferent |types, a|
|00003360| 6e 64 20 61 20 6c 69 73 | 74 20 63 61 6e 20 63 6f |nd a lis|t can co|
|00003370| 6e 74 61 69 6e 20 6f 74 | 68 65 72 20 6c 69 73 74 |ntain ot|her list|
|00003380| 73 20 6f 72 20 0d 72 65 | 63 6f 72 64 73 20 28 73 |s or .re|cords (s|
|00003390| 65 65 20 62 65 6c 6f 77 | 29 20 61 73 20 65 6c 65 |ee below|) as ele|
|000033a0| 6d 65 6e 74 73 2e 0d 0d | 4c 69 73 74 73 20 63 61 |ments...|Lists ca|
|000033b0| 6e 6e 6f 74 20 62 65 20 | 63 6f 65 72 63 65 64 20 |nnot be |coerced |
|000033c0| 74 6f 20 6f 74 68 65 72 | 20 74 79 70 65 73 3b 20 |to other| types; |
|000033d0| 74 68 65 20 74 79 70 65 | 20 6f 66 20 61 20 6c 69 |the type| of a li|
|000033e0| 73 74 20 69 73 20 61 6c | 77 61 79 73 20 27 6c 69 |st is al|ways 'li|
|000033f0| 73 74 27 2e 0d 0d 52 65 | 63 6f 72 64 73 0d 0d 41 |st'...Re|cords..A|
|00003400| 6e 20 41 45 52 65 63 6f | 72 64 20 69 73 20 69 6e |n AEReco|rd is in|
|00003410| 64 69 63 61 74 65 64 20 | 62 79 20 61 20 63 6f 6d |dicated |by a com|
|00003420| 6d 61 2d 73 65 70 61 72 | 61 74 65 64 20 6c 69 73 |ma-separ|ated lis|
|00003430| 74 20 6f 66 20 65 6c 65 | 6d 65 6e 74 73 20 65 6e |t of ele|ments en|
|00003440| 63 6c 6f 73 65 64 20 69 | 6e 20 63 75 72 6c 79 20 |closed i|n curly |
|00003450| 0d 62 72 61 63 65 73 2e | 20 45 61 63 68 20 65 6c |.braces.| Each el|
|00003460| 65 6d 65 6e 74 20 6f 66 | 20 61 20 72 65 63 6f 72 |ement of| a recor|
|00003470| 64 20 63 6f 6e 73 69 73 | 74 73 20 6f 66 20 61 20 |d consis|ts of a |
|00003480| 6b 65 79 77 6f 72 64 20 | 28 61 20 74 79 70 65 2d |keyword |(a type-|
|00003490| 63 6f 64 65 2c 20 61 73 | 20 64 65 73 63 72 69 62 |code, as| describ|
|000034a0| 65 64 20 0d 75 6e 64 65 | 72 20 42 61 73 69 63 20 |ed .unde|r Basic |
|000034b0| 54 79 70 65 73 29 20 66 | 6f 6c 6c 6f 77 65 64 20 |Types) f|ollowed |
|000034c0| 62 79 20 61 20 d2 3a d3 | 2c 20 66 6f 6c 6c 6f 77 |by a .:.|, follow|
|000034d0| 65 64 20 62 79 20 61 20 | 76 61 6c 75 65 2c 20 77 |ed by a |value, w|
|000034e0| 68 69 63 68 20 63 61 6e | 20 62 65 20 61 6e 79 20 |hich can| be any |
|000034f0| 0d 64 65 73 63 72 69 70 | 74 6f 72 3a 20 61 20 62 |.descrip|tor: a b|
|00003500| 61 73 69 63 20 74 79 70 | 65 2c 20 61 20 6c 69 73 |asic typ|e, a lis|
|00003510| 74 20 6f 72 20 61 6e 6f | 74 68 65 72 20 72 65 63 |t or ano|ther rec|
|00003520| 6f 72 64 2e 20 46 6f 72 | 20 65 78 61 6d 70 6c 65 |ord. For| example|
|00003530| 3a 0d 0d 09 7b 78 3a 31 | 30 30 2c 20 79 3a 2d 31 |:...{x:1|00, y:-1|
|00003540| 30 30 7d 0d 09 7b 27 6f | 72 69 67 69 6e 27 3a 20 |00}..{'o|rigin': |
|00003550| 7b 78 3a 31 30 30 2c 20 | 79 3a 2d 31 30 30 7d 2c |{x:100, |y:-100},|
|00003560| 20 65 78 74 65 6e 74 3a | 20 7b 78 3a 35 30 30 2c | extent:| {x:500,|
|00003570| 20 79 3a 35 30 30 7d 2c | 0d 09 20 63 6f 6e 74 3a | y:500},|.. cont:|
|00003580| 20 5b 31 2c 20 35 2c 20 | 32 35 5d 7d 0d 09 7b 7d | [1, 5, |25]}..{}|
|00003590| 0d 0d 54 68 65 20 64 65 | 66 61 75 6c 74 20 74 79 |..The de|fault ty|
|000035a0| 70 65 20 6f 66 20 61 20 | 72 65 63 6f 72 64 20 69 |pe of a |record i|
|000035b0| 73 20 27 72 65 63 6f 27 | 2e 20 20 4d 61 6e 79 20 |s 'reco'|.  Many |
|000035c0| 6f 66 20 74 68 65 20 41 | 70 70 6c 65 20 45 76 65 |of the A|pple Eve|
|000035d0| 6e 74 73 20 4f 62 6a 65 | 63 74 20 0d 4d 6f 64 65 |nts Obje|ct .Mode|
|000035e0| 6c 20 73 74 72 75 63 74 | 75 72 65 73 20 61 72 65 |l struct|ures are|
|000035f0| 20 41 45 52 65 63 6f 72 | 64 73 20 74 68 61 74 20 | AERecor|ds that |
|00003600| 68 61 76 65 20 62 65 65 | 6e 20 63 6f 65 72 63 65 |have bee|n coerce|
|00003610| 64 20 74 6f 20 73 6f 6d | 65 20 6f 74 68 65 72 20 |d to som|e other |
|00003620| 64 61 74 61 20 0d 74 79 | 70 65 2c 20 6c 69 6b 65 |data .ty|pe, like|
|00003630| 20 27 69 6e 64 78 27 20 | 6f 72 20 27 77 68 6f 73 | 'indx' |or 'whos|
|00003640| 27 2e 20 20 59 6f 75 20 | 63 61 6e 20 63 6f 65 72 |'.  You |can coer|
|00003650| 63 65 20 61 20 72 65 63 | 6f 72 64 20 73 74 72 75 |ce a rec|ord stru|
|00003660| 63 74 75 72 65 20 74 6f | 20 61 6e 79 20 0d 74 79 |cture to| any .ty|
|00003670| 70 65 20 62 79 20 70 72 | 65 63 65 64 69 6e 67 20 |pe by pr|eceding |
|00003680| 69 74 20 77 69 74 68 20 | 61 20 74 79 70 65 20 63 |it with |a type c|
|00003690| 6f 64 65 2e 20 20 46 6f | 72 20 65 78 61 6d 70 6c |ode.  Fo|r exampl|
|000036a0| 65 3a 0d 0d 09 72 61 6e | 67 7b 20 73 74 61 72 3a |e:...ran|g{ star:|
|000036b0| 20 35 2c 20 73 74 6f 70 | 3a 20 36 7d 0d 0d 73 20 | 5, stop|: 6}..s |
|000036c0| 57 61 72 6e 69 6e 67 20 | 43 6f 65 72 63 69 6e 67 |Warning |Coercing|
|000036d0| 20 74 6f 20 61 6e 20 65 | 78 69 73 74 69 6e 67 20 | to an e|xisting |
|000036e0| 74 79 70 65 2c 20 73 75 | 63 68 20 61 73 20 27 62 |type, su|ch as 'b|
|000036f0| 6f 6f 6c 27 20 6f 72 20 | 27 54 45 58 54 27 2c 20 |ool' or |'TEXT', |
|00003700| 69 73 20 61 20 0d 62 61 | 64 20 69 64 65 61 2e 20 |is a .ba|d idea. |
|00003710| 20 41 6e 79 6f 6e 65 20 | 70 61 72 73 69 6e 67 20 | Anyone |parsing |
|00003720| 74 68 65 20 64 65 73 63 | 72 69 70 74 6f 72 20 28 |the desc|riptor (|
|00003730| 69 6e 63 6c 75 64 69 6e | 67 20 41 45 50 72 69 6e |includin|g AEPrin|
|00003740| 74 29 20 77 69 6c 6c 20 | 0d 72 65 63 6f 67 6e 69 |t) will |.recogni|
|00003750| 7a 65 20 74 68 65 20 74 | 79 70 65 20 61 6e 64 20 |ze the t|ype and |
|00003760| 61 73 73 75 6d 65 20 74 | 68 61 74 20 74 68 65 20 |assume t|hat the |
|00003770| 64 61 74 61 20 68 61 73 | 20 74 68 65 20 6e 6f 72 |data has| the nor|
|00003780| 6d 61 6c 20 0d 69 6e 74 | 65 72 70 72 65 74 61 74 |mal .int|erpretat|
|00003790| 69 6f 6e 2c 20 77 68 69 | 63 68 20 69 6e 20 74 68 |ion, whi|ch in th|
|000037a0| 69 73 20 63 61 73 65 20 | 69 74 20 77 6f 75 6c 64 |is case |it would|
|000037b0| 6e d5 74 2e 20 20 42 61 | 64 20 74 6f 20 61 77 66 |n.t.  Ba|d to awf|
|000037c0| 75 6c 20 74 68 69 6e 67 | 73 20 0d 77 6f 75 6c 64 |ul thing|s .would|
|000037d0| 20 68 61 70 70 65 6e 2e | 20 20 44 6f 6e d5 74 20 | happen.|  Don.t |
|000037e0| 64 6f 20 69 74 2e 0d 0d | 41 70 70 6c 65 20 45 76 |do it...|Apple Ev|
|000037f0| 65 6e 74 73 0d 0d 54 68 | 65 20 73 79 6e 74 61 78 |ents..Th|e syntax|
|00003800| 20 6f 66 20 74 68 65 20 | 66 6f 72 6d 61 74 74 69 | of the |formatti|
|00003810| 6e 67 20 73 74 72 69 6e | 67 20 66 6f 72 20 61 6e |ng strin|g for an|
|00003820| 20 65 6e 74 69 72 65 20 | 41 70 70 6c 65 20 65 76 | entire |Apple ev|
|00003830| 65 6e 74 20 28 61 73 20 | 70 61 73 73 65 64 20 74 |ent (as |passed t|
|00003840| 6f 20 0d 41 45 42 75 69 | 6c 64 41 70 70 6c 65 45 |o .AEBui|ldAppleE|
|00003850| 76 65 6e 74 29 20 69 73 | 20 61 6c 6d 6f 73 74 20 |vent) is| almost |
|00003860| 69 64 65 6e 74 69 63 61 | 6c 20 74 6f 20 74 68 61 |identica|l to tha|
|00003870| 74 20 6f 66 20 61 20 72 | 65 63 6f 72 64 2e 20 45 |t of a r|ecord. E|
|00003880| 61 63 68 20 6b 65 79 65 | 64 20 65 6c 65 6d 65 6e |ach keye|d elemen|
|00003890| 74 20 0d 73 70 65 63 69 | 66 69 65 64 20 69 6e 20 |t .speci|fied in |
|000038a0| 74 68 65 20 73 74 72 69 | 6e 67 20 62 65 63 6f 6d |the stri|ng becom|
|000038b0| 65 73 20 61 20 70 61 72 | 61 6d 65 74 65 72 20 6f |es a par|ameter o|
|000038c0| 72 20 61 74 74 72 69 62 | 75 74 65 20 6f 66 20 74 |r attrib|ute of t|
|000038d0| 68 65 20 65 76 65 6e 74 | 2e 20 54 68 65 20 0d 64 |he event|. The .d|
|000038e0| 69 66 66 65 72 65 6e 63 | 65 73 20 61 72 65 3a 0d |ifferenc|es are:.|
|000038f0| 0d a5 09 54 68 65 72 65 | 20 61 72 65 20 6e 6f 20 |...There| are no |
|00003900| 63 75 72 6c 79 2d 62 72 | 61 63 65 73 20 61 74 20 |curly-br|aces at |
|00003910| 74 68 65 20 62 65 67 69 | 6e 6e 69 6e 67 20 61 6e |the begi|nning an|
|00003920| 64 20 65 6e 64 20 6f 66 | 20 74 68 65 20 73 74 72 |d end of| the str|
|00003930| 69 6e 67 2e 0d a5 09 54 | 68 65 20 63 68 61 72 61 |ing....T|he chara|
|00003940| 63 74 65 72 20 d2 7e d3 | 20 62 65 66 6f 72 65 20 |cter .~.| before |
|00003950| 61 20 70 61 72 61 6d 65 | 74 65 72 20 6b 65 79 77 |a parame|ter keyw|
|00003960| 6f 72 64 20 6d 61 6b 65 | 73 20 69 74 20 6f 70 74 |ord make|s it opt|
|00003970| 69 6f 6e 61 6c 2e 0d 0d | 48 65 72 65 d5 73 20 61 |ional...|Here.s a|
|00003980| 6e 20 65 78 61 6d 70 6c | 65 20 6f 66 20 68 6f 77 |n exampl|e of how|
|00003990| 20 74 6f 20 63 6f 6e 73 | 74 72 75 63 74 20 61 6e | to cons|truct an|
|000039a0| 20 4f 70 65 6e 20 53 65 | 6c 65 63 74 69 6f 6e 20 | Open Se|lection |
|000039b0| 65 76 65 6e 74 20 66 6f | 72 20 74 68 65 20 46 69 |event fo|r the Fi|
|000039c0| 6e 64 65 72 3a 0d 0d 09 | 41 6c 69 61 73 48 61 6e |nder:...|AliasHan|
|000039d0| 64 6c 65 20 70 61 72 65 | 6e 74 2c 20 69 74 65 6d |dle pare|nt, item|
|000039e0| 54 6f 4f 70 65 6e 3b 0d | 09 63 6f 6e 73 74 20 4f |ToOpen;.|.const O|
|000039f0| 53 54 79 70 65 20 66 69 | 6e 64 65 72 53 69 67 6e |SType fi|nderSign|
|00003a00| 61 74 75 72 65 20 3d 20 | 27 4d 41 43 53 27 3b 0d |ature = |'MACS';.|
|00003a10| 09 41 70 70 6c 65 45 76 | 65 6e 74 20 65 76 65 6e |.AppleEv|ent even|
|00003a20| 74 3b 0d 09 4f 53 45 72 | 72 20 65 72 72 3b 0d 0d |t;..OSEr|r err;..|
|00003a30| 09 2f 2f 20 43 6f 6e 73 | 74 72 75 63 74 20 74 68 |.// Cons|truct th|
|00003a40| 65 20 61 6c 69 61 73 65 | 73 20 68 65 72 65 20 28 |e aliase|s here (|
|00003a50| 6e 6f 74 20 73 68 6f 77 | 6e 29 0d 0d 09 65 72 72 |not show|n)...err|
|00003a60| 3d 20 41 45 42 75 69 6c | 64 45 70 70 6c 65 45 76 |= AEBuil|dEppleEv|
|00003a70| 65 6e 74 28 0d 09 09 09 | 27 46 4e 44 52 27 2c 20 |ent(....|'FNDR', |
|00003a80| 27 53 4f 50 45 27 2c 0d | 09 09 09 74 79 70 65 41 |'SOPE',.|...typeA|
|00003a90| 70 70 6c 53 69 67 6e 61 | 74 75 72 65 2c 20 40 66 |pplSigna|ture, @f|
|00003aa0| 69 6e 64 65 72 53 69 67 | 6e 61 74 75 72 65 2c 20 |inderSig|nature, |
|00003ab0| 73 69 7a 65 6f 66 28 66 | 69 6e 64 65 72 53 69 67 |sizeof(f|inderSig|
|00003ac0| 6e 61 74 75 72 65 29 2c | 0d 09 09 09 6b 41 75 74 |nature),|....kAut|
|00003ad0| 6f 47 65 6e 65 72 61 74 | 65 52 65 74 75 72 6e 49 |oGenerat|eReturnI|
|00003ae0| 44 2c 20 6b 41 6e 79 54 | 72 61 6e 73 61 63 74 69 |D, kAnyT|ransacti|
|00003af0| 6f 6e 49 44 2c 0d 09 09 | 09 26 65 76 65 6e 74 2c |onID,...|.&event,|
|00003b00| 09 09 09 09 09 09 09 09 | 09 09 2f 2f 20 45 76 65 |........|..// Eve|
|00003b10| 6e 74 20 74 6f 20 62 65 | 20 63 72 65 61 74 65 64 |nt to be| created|
|00003b20| 0d 09 09 09 22 2d 2d 2d | 2d 3a 20 61 6c 69 73 28 |...."---|-: alis(|
|00003b30| 40 40 29 2c 20 66 73 65 | 6c 3a 20 5b 61 6c 69 73 |@@), fse|l: [alis|
|00003b40| 28 40 40 29 5d 22 2c 09 | 09 09 2f 2f 20 46 6f 72 |(@@)]",.|..// For|
|00003b50| 6d 61 74 20 73 74 72 69 | 6e 67 0d 09 09 09 09 70 |mat stri|ng.....p|
|00003b60| 61 72 65 6e 74 2c 09 09 | 09 09 09 09 09 09 09 2f |arent,..|......./|
|00003b70| 2f 20 70 61 72 61 6d 20 | 66 6f 72 20 31 73 74 20 |/ param |for 1st |
|00003b80| 40 40 0d 09 09 09 09 69 | 74 65 6d 54 6f 4f 70 65 |@@.....i|temToOpe|
|00003b90| 6e 09 09 09 09 09 09 09 | 09 2f 2f 20 70 61 72 61 |n.......|.// para|
|00003ba0| 6d 20 66 6f 72 20 32 6e | 64 20 40 40 0d 09 29 3b |m for 2n|d @@..);|
|00003bb0| 0d 09 0d 53 75 62 73 74 | 69 74 75 74 69 6e 67 20 |...Subst|ituting |
|00003bc0| 50 61 72 61 6d 65 74 65 | 72 73 0d 0d 54 6f 20 70 |Paramete|rs..To p|
|00003bd0| 6c 75 67 20 79 6f 75 72 | 20 6f 77 6e 20 76 61 6c |lug your| own val|
|00003be0| 75 65 73 20 69 6e 74 6f | 20 74 68 65 20 6d 69 64 |ues into| the mid|
|00003bf0| 73 74 20 6f 66 20 61 20 | 64 65 73 63 72 69 70 74 |st of a |descript|
|00003c00| 6f 72 2c 20 75 73 65 20 | 74 68 65 20 6d 61 67 69 |or, use |the magi|
|00003c10| 63 20 d2 40 d3 20 0d 63 | 68 61 72 61 63 74 65 72 |c .@. .c|haracter|
|00003c20| 2e 20 59 6f 75 20 63 61 | 6e 20 75 73 65 20 d2 40 |. You ca|n use .@|
|00003c30| d3 20 61 6e 79 77 68 65 | 72 65 20 79 6f 75 20 63 |. anywhe|re you c|
|00003c40| 61 6e 20 70 75 74 20 61 | 20 62 61 73 69 63 20 65 |an put a| basic e|
|00003c50| 6c 65 6d 65 6e 74 20 6c | 69 6b 65 20 61 6e 20 69 |lement l|ike an i|
|00003c60| 6e 74 65 67 65 72 2e 20 | 0d 45 61 63 68 20 d2 40 |nteger. |.Each .@|
|00003c70| d3 20 69 73 20 72 65 70 | 6c 61 63 65 64 20 62 79 |. is rep|laced by|
|00003c80| 20 61 20 76 61 6c 75 65 | 20 74 61 6b 65 6e 20 66 | a value| taken f|
|00003c90| 72 6f 6d 20 74 68 65 20 | 70 61 72 61 6d 65 74 65 |rom the |paramete|
|00003ca0| 72 20 6c 69 73 74 20 73 | 65 6e 74 20 74 6f 20 74 |r list s|ent to t|
|00003cb0| 68 65 20 41 45 42 75 69 | 6c 64 20 0d 66 75 6e 63 |he AEBui|ld .func|
|00003cc0| 74 69 6f 6e 2e 20 54 68 | 65 20 74 79 70 65 20 6f |tion. Th|e type o|
|00003cd0| 66 20 76 61 6c 75 65 20 | 63 72 65 61 74 65 64 20 |f value |created |
|00003ce0| 64 65 70 65 6e 64 73 20 | 6f 6e 20 74 68 65 20 63 |depends |on the c|
|00003cf0| 6f 6e 74 65 78 74 20 69 | 6e 20 77 68 69 63 68 20 |ontext i|n which |
|00003d00| 74 68 65 20 d2 40 d3 20 | 69 73 20 0d 75 73 65 64 |the .@. |is .used|
|00003d10| 3a 20 69 6e 20 70 61 72 | 74 69 63 75 6c 61 72 2c |: in par|ticular,|
|00003d20| 20 68 6f 77 20 69 74 d5 | 73 20 63 6f 65 72 63 65 | how it.|s coerce|
|00003d30| 64 2e 0d 0d 54 79 70 65 | 20 43 6f 65 72 63 65 64 |d...Type| Coerced|
|00003d40| 20 74 6f 3a 09 54 79 70 | 65 20 6f 66 20 66 6e 20 | to:.Typ|e of fn |
|00003d50| 70 61 72 61 6d 65 74 65 | 72 20 72 65 61 64 3a 09 |paramete|r read:.|
|00003d60| 09 09 43 6f 6d 6d 65 6e | 74 73 3a 0d 2d 2d 2d 2d |..Commen|ts:.----|
|00003d70| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 09 2d 2d 2d |--------|----.---|
|00003d80| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00003d90| 2d 2d 2d 2d 2d 2d 2d 09 | 09 09 2d 2d 2d 2d 2d 2d |-------.|..------|
|00003da0| 2d 2d 2d 0d 4e 6f 20 63 | 6f 65 72 63 69 6f 6e 09 |---.No c|oercion.|
|00003db0| 09 09 41 45 44 65 73 63 | 2a 09 09 09 09 09 09 09 |..AEDesc|*.......|
|00003dc0| 09 41 20 70 6c 61 69 6e | 20 d2 40 d3 20 77 69 6c |.A plain| .@. wil|
|00003dd0| 6c 20 62 65 20 72 65 70 | 6c 61 63 65 64 20 77 69 |l be rep|laced wi|
|00003de0| 74 68 20 61 0d 09 09 09 | 09 09 09 09 09 09 09 09 |th a....|........|
|00003df0| 09 09 09 64 65 73 63 72 | 69 70 74 6f 72 20 70 61 |...descr|iptor pa|
|00003e00| 72 61 6d 65 74 65 72 2e | 0d 09 09 09 09 09 09 09 |rameter.|........|
|00003e10| 09 09 09 09 09 09 09 0d | 4e 75 6d 65 72 69 63 20 |........|Numeric |
|00003e20| 09 09 09 28 62 6f 6f 6c | 2c 20 73 68 6f 72 2c 0d |...(bool|, shor,.|
|00003e30| 09 09 09 09 09 6c 6f 6e | 67 2c 20 73 69 6e 67 2c |.....lon|g, sing,|
|00003e40| 20 64 6f 75 62 2c 20 65 | 78 74 65 29 09 73 68 6f | doub, e|xte).sho|
|00003e50| 72 74 2c 20 73 68 6f 72 | 74 2c 20 6c 6f 6e 67 2c |rt, shor|t, long,|
|00003e60| 20 66 6c 6f 61 74 2c 0d | 09 09 09 09 09 73 68 6f | float,.|.....sho|
|00003e70| 72 74 20 64 6f 75 62 6c | 65 2c 20 64 6f 75 62 6c |rt doubl|e, doubl|
|00003e80| 65 09 09 09 09 52 65 6d | 65 6d 62 65 72 20 74 68 |e....Rem|ember th|
|00003e90| 61 74 20 54 48 49 4e 4b | 20 43 d5 73 20 64 6f 75 |at THINK| C.s dou|
|00003ea0| 62 6c 65 0d 09 09 09 09 | 09 09 09 09 09 09 09 09 |ble.....|........|
|00003eb0| 09 09 63 6f 72 72 65 73 | 70 6f 6e 64 73 20 74 6f |..corres|ponds to|
|00003ec0| 20 74 79 70 65 20 27 65 | 78 74 65 27 21 0d 09 09 | type 'e|xte'!...|
|00003ed0| 09 09 09 09 09 09 09 09 | 09 09 09 09 0d 54 45 58 |........|.....TEX|
|00003ee0| 54 09 09 09 09 63 68 61 | 72 2a 09 09 09 09 09 09 |T....cha|r*......|
|00003ef0| 09 09 50 6f 69 6e 74 65 | 72 20 74 6f 20 61 20 6e |..Pointe|r to a n|
|00003f00| 75 6c 6c 2d 74 65 72 6d | 69 6e 61 74 65 64 20 43 |ull-term|inated C|
|00003f10| 20 73 74 72 69 6e 67 2e | 0d 0d 41 6e 79 20 6f 74 | string.|..Any ot|
|00003f20| 68 65 72 20 74 79 70 65 | 09 09 6c 6f 6e 67 20 66 |her type|..long f|
|00003f30| 6f 6c 6c 6f 77 65 64 20 | 62 79 20 76 6f 69 64 2a |ollowed |by void*|
|00003f40| 09 09 09 09 45 78 70 65 | 63 74 73 20 61 20 6c 65 |....Expe|cts a le|
|00003f50| 6e 67 74 68 20 70 61 72 | 61 6d 65 74 65 72 20 66 |ngth par|ameter f|
|00003f60| 6f 6c 6c 6f 77 65 64 20 | 62 79 0d 09 09 09 09 09 |ollowed |by......|
|00003f70| 09 09 09 09 09 09 09 09 | 09 61 20 70 6f 69 6e 74 |........|.a point|
|00003f80| 65 72 20 74 6f 20 74 68 | 65 20 64 65 73 63 72 69 |er to th|e descri|
|00003f90| 70 74 6f 72 20 64 61 74 | 61 2e 0d 09 09 09 09 09 |ptor dat|a.......|
|00003fa0| 09 09 09 09 09 09 09 09 | 09 0d 73 09 49 6d 70 6f |........|..s.Impo|
|00003fb0| 72 74 61 6e 74 09 4e 6f | 74 65 20 70 61 72 74 69 |rtant.No|te parti|
|00003fc0| 63 75 6c 61 72 6c 79 3a | 20 74 68 61 74 20 54 45 |cularly:| that TE|
|00003fd0| 58 54 20 70 61 72 61 6d | 65 74 65 72 73 20 6d 75 |XT param|eters mu|
|00003fe0| 73 74 20 62 65 20 6e 75 | 6c 6c 2d 74 65 72 6d 69 |st be nu|ll-termi|
|00003ff0| 6e 61 74 65 64 20 0d 73 | 74 72 69 6e 67 73 2c 20 |nated .s|trings, |
|00004000| 61 6c 74 68 6f 75 67 68 | 20 74 68 65 20 72 65 73 |although| the res|
|00004010| 75 6c 74 69 6e 67 20 64 | 65 73 63 72 69 70 74 6f |ulting d|escripto|
|00004020| 72 20 64 61 74 61 20 77 | 69 6c 6c 20 6e 6f 74 20 |r data w|ill not |
|00004030| 62 65 20 6e 75 6c 6c 2d | 0d 74 65 72 6d 69 6e 61 |be null-|.termina|
|00004040| 74 65 64 3b 20 61 6e 64 | 20 74 68 61 74 20 74 68 |ted; and| that th|
|00004050| 65 20 67 65 6e 65 72 61 | 6c 20 63 61 73 65 20 65 |e genera|l case e|
|00004060| 78 70 65 63 74 73 20 74 | 77 6f 20 70 61 72 61 6d |xpects t|wo param|
|00004070| 65 74 65 72 73 3a 20 74 | 68 65 20 0d 64 61 74 61 |eters: t|he .data|
|00004080| d5 73 20 73 69 7a 65 20 | 61 6e 64 20 6c 6f 63 61 |.s size |and loca|
|00004090| 74 69 6f 6e 2e 20 ca ca | 73 0d 0d 49 6e 20 61 64 |tion. ..|s..In ad|
|000040a0| 64 69 74 69 6f 6e 2c 20 | 79 6f 75 20 63 61 6e 20 |dition, |you can |
|000040b0| 73 75 62 73 74 69 74 75 | 74 65 20 64 61 74 61 20 |substitu|te data |
|000040c0| 66 72 6f 6d 20 61 20 68 | 61 6e 64 6c 65 20 62 79 |from a h|andle by|
|000040d0| 20 75 73 69 6e 67 20 74 | 77 6f 20 40 20 73 69 67 | using t|wo @ sig|
|000040e0| 6e 73 2e 20 41 6e 20 d2 | 40 40 d3 20 0d 70 61 72 |ns. An .|@@. .par|
|000040f0| 61 6d 65 74 65 72 20 77 | 69 6c 6c 20 72 65 61 64 |ameter w|ill read|
|00004100| 20 61 20 73 69 6e 67 6c | 65 20 68 61 6e 64 6c 65 | a singl|e handle|
|00004110| 20 66 72 6f 6d 20 74 68 | 65 20 70 61 72 61 6d 65 | from th|e parame|
|00004120| 74 65 72 20 6c 69 73 74 | 20 61 6e 64 20 75 73 65 |ter list| and use|
|00004130| 20 74 68 65 20 64 61 74 | 61 20 0d 70 6f 69 6e 74 | the dat|a .point|
|00004140| 65 64 20 74 6f 20 62 79 | 20 74 68 61 74 20 68 61 |ed to by| that ha|
|00004150| 6e 64 6c 65 20 61 73 20 | 74 68 65 20 76 61 6c 75 |ndle as |the valu|
|00004160| 65 20 6f 66 20 74 68 65 | 20 64 65 73 63 72 69 70 |e of the| descrip|
|00004170| 74 6f 72 2e 20 54 68 65 | 20 d2 40 40 d3 20 6d 75 |tor. The| .@@. mu|
|00004180| 73 74 20 62 65 20 0d 63 | 6f 65 72 63 65 64 20 73 |st be .c|oerced s|
|00004190| 6f 20 74 68 61 74 20 41 | 45 42 75 69 6c 64 20 77 |o that A|EBuild w|
|000041a0| 69 6c 6c 20 6b 6e 6f 77 | 20 77 68 61 74 20 74 79 |ill know| what ty|
|000041b0| 70 65 20 74 6f 20 6d 61 | 6b 65 20 74 68 65 20 64 |pe to ma|ke the d|
|000041c0| 65 73 63 72 69 70 74 6f | 72 3b 20 68 6f 77 65 76 |escripto|r; howev|
|000041d0| 65 72 2c 20 0d 74 68 65 | 20 74 79 70 65 20 63 6f |er, .the| type co|
|000041e0| 65 72 63 65 64 20 74 6f | 20 63 61 6e 20 62 65 20 |erced to| can be |
|000041f0| 61 6e 79 74 68 69 6e 67 | 20 28 74 68 65 20 74 61 |anything| (the ta|
|00004200| 62 6c 65 20 61 62 6f 76 | 65 20 69 73 20 69 67 6e |ble abov|e is ign|
|00004210| 6f 72 65 64 2e 29 0d 0d | 54 68 69 73 20 6d 65 63 |ored.)..|This mec|
|00004220| 68 61 6e 69 73 6d 20 69 | 73 20 73 74 69 6c 6c 20 |hanism i|s still |
|00004230| 61 20 62 69 74 20 6c 69 | 6d 69 74 65 64 2c 20 61 |a bit li|mited, a|
|00004240| 6e 64 20 6d 61 79 20 77 | 65 6c 6c 20 62 65 20 69 |nd may w|ell be i|
|00004250| 6d 70 72 6f 76 65 64 20 | 69 6e 20 74 68 65 20 66 |mproved |in the f|
|00004260| 75 74 75 72 65 2e 0d 0d | 44 65 73 63 72 69 70 74 |uture...|Descript|
|00004270| 6f 72 2d 53 74 72 69 6e | 67 20 47 72 61 6d 6d 61 |or-Strin|g Gramma|
|00004280| 72 0d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |r.------|--------|
|00004290| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 0d 0d 53 69 6e |--------|---..Sin|
|000042a0| 63 65 20 6e 6f 20 6c 61 | 6e 67 75 61 67 65 2c 20 |ce no la|nguage, |
|000042b0| 68 6f 77 65 76 65 72 20 | 73 6d 61 6c 6c 2c 20 63 |however |small, c|
|000042c0| 61 6e 20 62 65 20 74 61 | 6b 65 6e 20 73 65 72 69 |an be ta|ken seri|
|000042d0| 6f 75 73 6c 79 20 75 6e | 6c 65 73 73 20 69 74 20 |ously un|less it |
|000042e0| 63 6f 6d 65 73 20 66 75 | 6c 6c 79 20 0d 65 71 75 |comes fu|lly .equ|
|000042f0| 69 70 70 65 64 20 77 69 | 74 68 20 61 20 66 6f 72 |ipped wi|th a for|
|00004300| 6d 69 64 61 62 6c 65 2d | 6c 6f 6f 6b 69 6e 67 20 |midable-|looking |
|00004310| 42 4e 46 20 67 72 61 6d | 6d 61 72 20 73 70 65 63 |BNF gram|mar spec|
|00004320| 69 66 69 63 61 74 69 6f | 6e 2c 20 49 20 68 65 72 |ificatio|n, I her|
|00004330| 65 20 70 72 65 73 65 6e | 74 20 0d 6f 6e 65 2e 20 |e presen|t .one. |
|00004340| 4e 6f 20 61 74 74 65 6d | 70 74 20 68 61 73 20 62 |No attem|pt has b|
|00004350| 65 65 6e 20 6d 61 64 65 | 20 74 6f 20 70 72 65 76 |een made| to prev|
|00004360| 65 6e 74 20 4d 65 73 73 | 72 73 2e 20 42 61 63 6b |ent Mess|rs. Back|
|00004370| 75 73 20 61 6e 64 2f 6f | 72 20 4e 61 75 72 20 66 |us and/o|r Naur f|
|00004380| 72 6f 6d 20 0d 72 6f 6c | 6c 69 6e 67 20 6f 76 65 |rom .rol|ling ove|
|00004390| 72 20 69 6e 20 74 68 65 | 69 72 20 72 65 73 70 65 |r in the|ir respe|
|000043a0| 63 74 69 76 65 20 67 72 | 61 76 65 73 2e 0d 0d 43 |ctive gr|aves...C|
|000043b0| 68 61 72 61 63 74 65 72 | 20 43 6c 61 73 73 69 66 |haracter| Classif|
|000043c0| 69 63 61 74 69 6f 6e 3a | 0d 0d 77 68 69 74 65 73 |ication:|..whites|
|000043d0| 70 61 63 65 09 d4 20 d5 | 2c 20 d4 5c 72 d5 2c 20 |pace.. .|, .\r., |
|000043e0| d4 5c 6e d5 2c 20 d4 5c | 74 d5 0d 64 69 67 69 74 |.\n., .\|t..digit|
|000043f0| 09 30 20 c9 20 39 0d 70 | 61 72 65 6e 2c 20 62 72 |.0 . 9.p|aren, br|
|00004400| 61 63 6b 65 74 2c 0d 62 | 72 61 63 65 73 09 28 2c |acket,.b|races.(,|
|00004410| 20 29 2c 20 5b 2c 20 5d | 2c 20 7b 2c 20 7d 0d 73 | ), [, ]|, {, }.s|
|00004420| 69 6e 67 6c 65 2d 71 75 | 6f 74 65 09 27 0d 64 6f |ingle-qu|ote.'.do|
|00004430| 75 62 6c 65 20 71 75 6f | 74 65 73 09 d2 2c 20 d3 |uble quo|tes.., .|
|00004440| 0d 68 65 78 20 71 75 6f | 74 65 73 09 c7 2c 20 c8 |.hex quo|tes.., .|
|00004450| 0d 63 6f 6c 6f 6e 09 3a | 0d 63 6f 6d 6d 61 09 2c |.colon.:|.comma.,|
|00004460| 0d 61 74 2d 73 69 67 6e | 09 40 0d 69 64 65 6e 74 |.at-sign|.@.ident|
|00004470| 63 68 61 72 09 61 6e 79 | 20 6f 74 68 65 72 20 70 |char.any| other p|
|00004480| 72 69 6e 74 61 62 6c 65 | 20 63 68 61 72 61 63 74 |rintable| charact|
|00004490| 65 72 0d 0d 54 6f 6b 65 | 6e 73 3a 0d 0d 69 64 65 |er..Toke|ns:..ide|
|000044a0| 6e 74 20 3a 3a 3d 09 69 | 64 65 6e 74 63 68 61 72 |nt ::=.i|dentchar|
|000044b0| 20 28 69 64 65 6e 74 63 | 68 61 72 20 7c 20 64 69 | (identc|har | di|
|000044c0| 67 69 74 29 2a 09 d1 50 | 61 64 64 65 64 2f 74 72 |git)*..P|added/tr|
|000044d0| 75 6e 63 61 74 65 64 0d | 09 27 20 63 68 61 72 61 |uncated.|.' chara|
|000044e0| 63 74 65 72 2a 20 27 09 | 74 6f 20 65 78 61 63 74 |cter* '.|to exact|
|000044f0| 6c 79 20 34 20 63 68 61 | 72 73 0d 69 6e 74 65 67 |ly 4 cha|rs.integ|
|00004500| 65 72 20 3a 3a 3d 09 5b | 20 2d 20 5d 20 64 69 67 |er ::=.[| - ] dig|
|00004510| 69 74 2b 09 d1 4a 75 73 | 74 20 61 73 20 69 6e 20 |it+..Jus|t as in |
|00004520| 43 0d 73 74 72 69 6e 67 | 20 3a 3a 3d 09 d2 20 28 |C.string| ::=.. (|
|00004530| 63 68 61 72 61 63 74 65 | 72 29 2a 20 d3 0d 68 65 |characte|r)* ..he|
|00004540| 78 73 74 72 69 6e 67 20 | 3a 3a 3d 09 c7 20 28 68 |xstring |::=.. (h|
|00004550| 65 78 64 69 67 69 74 20 | 7c 20 77 68 69 74 65 73 |exdigit || whites|
|00004560| 70 61 63 65 29 2a 20 c8 | 09 d1 45 76 65 6e 20 6e |pace)* .|..Even n|
|00004570| 6f 2e 20 6f 66 20 64 69 | 67 69 74 73 2c 20 70 6c |o. of di|gits, pl|
|00004580| 65 61 73 65 0d 0d 47 72 | 61 6d 6d 61 72 20 52 75 |ease..Gr|ammar Ru|
|00004590| 6c 65 73 20 66 6f 72 20 | 41 45 42 75 69 6c 64 3a |les for |AEBuild:|
|000045a0| 0d 0d 66 6f 72 6d 61 74 | 73 74 72 69 6e 67 20 3a |..format|string :|
|000045b0| 3a 3d 09 6f 62 6a 09 d1 | 54 68 69 73 20 69 73 20 |:=.obj..|This is |
|000045c0| 74 68 65 20 74 6f 70 20 | 6c 65 76 65 6c 20 6f 66 |the top |level of|
|000045d0| 20 73 79 6e 74 61 78 0d | 6f 62 6a 20 3a 3a 3d 09 | syntax.|obj ::=.|
|000045e0| 64 61 74 61 09 d1 53 69 | 6e 67 6c 65 20 41 45 44 |data..Si|ngle AED|
|000045f0| 65 73 63 3b 20 73 68 6f | 72 74 63 75 74 20 66 6f |esc; sho|rtcut fo|
|00004600| 72 20 28 64 61 74 61 29 | 0d 09 73 74 72 75 63 74 |r (data)|..struct|
|00004610| 75 72 65 09 d1 55 6e 2d | 63 6f 65 72 63 65 64 20 |ure..Un-|coerced |
|00004620| 73 74 72 75 63 74 75 72 | 65 0d 09 69 64 65 6e 74 |structur|e..ident|
|00004630| 20 73 74 72 75 63 74 75 | 72 65 09 d1 43 6f 65 72 | structu|re..Coer|
|00004640| 63 65 64 20 74 6f 20 73 | 6f 6d 65 20 6f 74 68 65 |ced to s|ome othe|
|00004650| 72 20 74 79 70 65 0d 73 | 74 72 75 63 74 75 72 65 |r type.s|tructure|
|00004660| 20 3a 3a 3d 09 28 20 64 | 61 74 61 20 29 09 d1 53 | ::=.( d|ata )..S|
|00004670| 69 6e 67 6c 65 20 41 45 | 44 65 73 63 0d 09 5b 20 |ingle AE|Desc..[ |
|00004680| 6f 62 6a 65 63 74 6c 69 | 73 74 20 5d 09 d1 41 45 |objectli|st ]..AE|
|00004690| 4c 69 73 74 20 74 79 70 | 65 0d 09 7b 20 6b 65 79 |List typ|e..{ key|
|000046a0| 77 6f 72 64 6c 69 73 74 | 20 7d 09 d1 41 45 52 65 |wordlist| }..AERe|
|000046b0| 63 6f 72 64 20 74 79 70 | 65 0d 6f 62 6a 65 63 74 |cord typ|e.object|
|000046c0| 6c 69 73 74 20 3a 3a 3d | 09 c7 62 6c 61 6e 6b c8 |list ::=|..blank.|
|000046d0| 09 d1 43 6f 6d 6d 61 2d | 73 65 70 61 72 61 74 65 |..Comma-|separate|
|000046e0| 64 20 6c 69 73 74 20 6f | 66 20 74 68 69 6e 67 73 |d list o|f things|
|000046f0| 0d 09 6f 62 6a 20 5b 20 | 2c 20 6f 62 6a 20 5d 2a |..obj [ |, obj ]*|
|00004700| 0d 6b 65 79 77 6f 72 64 | 70 61 69 72 20 3a 3a 3d |.keyword|pair ::=|
|00004710| 09 69 64 65 6e 74 20 3a | 20 6f 62 6a 09 d1 4b 65 |.ident :| obj..Ke|
|00004720| 79 77 6f 72 64 2f 76 61 | 6c 75 65 20 70 61 69 72 |yword/va|lue pair|
|00004730| 0d 6b 65 79 77 6f 72 64 | 6c 69 73 74 20 3a 3a 3d |.keyword|list ::=|
|00004740| 09 c7 62 6c 61 6e 6b c8 | 09 d1 4c 69 73 74 20 6f |..blank.|..List o|
|00004750| 66 20 73 61 69 64 20 70 | 61 69 72 73 0d 09 6b 65 |f said p|airs..ke|
|00004760| 79 77 6f 72 64 70 61 69 | 72 20 5b 20 2c 20 6b 65 |ywordpai|r [ , ke|
|00004770| 79 77 6f 72 64 70 61 69 | 72 20 5d 2a 0d 64 61 74 |ywordpai|r ]*.dat|
|00004780| 61 20 3a 3a 3d 09 40 09 | d1 47 65 74 73 20 61 70 |a ::=.@.|.Gets ap|
|00004790| 70 72 6f 70 72 69 61 74 | 65 20 64 61 74 61 20 66 |propriat|e data f|
|000047a0| 72 6f 6d 20 66 6e 20 70 | 61 72 61 6d 0d 09 69 6e |rom fn p|aram..in|
|000047b0| 74 65 67 65 72 09 d1 27 | 73 68 6f 72 27 20 6f 72 |teger..'|shor' or|
|000047c0| 20 27 6c 6f 6e 67 27 20 | 75 6e 6c 65 73 73 20 63 | 'long' |unless c|
|000047d0| 6f 65 72 63 65 64 0d 09 | 69 64 65 6e 74 09 d1 41 |oerced..|ident..A|
|000047e0| 20 34 2d 63 68 61 72 20 | 74 79 70 65 20 63 6f 64 | 4-char |type cod|
|000047f0| 65 20 28 27 74 79 70 65 | 27 29 20 75 6e 6c 65 73 |e ('type|') unles|
|00004800| 73 20 63 6f 65 72 63 65 | 64 0d 09 73 74 72 69 6e |s coerce|d..strin|
|00004810| 67 09 d1 55 6e 74 65 72 | 6d 69 6e 61 74 65 64 20 |g..Unter|minated |
|00004820| 74 65 78 74 3b 20 27 54 | 45 58 54 27 20 74 79 70 |text; 'T|EXT' typ|
|00004830| 65 20 75 6e 6c 65 73 73 | 20 63 6f 65 72 63 65 64 |e unless| coerced|
|00004840| 0d 09 68 65 78 73 74 72 | 69 6e 67 09 d1 52 61 77 |..hexstr|ing..Raw|
|00004850| 20 68 65 78 20 64 61 74 | 61 3b 20 6d 75 73 74 20 | hex dat|a; must |
|00004860| 62 65 20 63 6f 65 72 63 | 65 64 20 74 6f 20 73 6f |be coerc|ed to so|
|00004870| 6d 65 20 74 79 70 65 21 | 0d 09 0d 47 72 61 6d 6d |me type!|...Gramm|
|00004880| 61 72 20 52 75 6c 65 73 | 20 66 6f 72 20 41 45 42 |ar Rules| for AEB|
|00004890| 75 69 6c 64 41 70 70 6c | 65 45 76 65 6e 74 3a 0d |uildAppl|eEvent:.|
|000048a0| 0d 65 76 65 6e 74 73 74 | 72 69 6e 67 20 3a 3a 3d |.eventst|ring ::=|
|000048b0| 09 65 76 74 6b 65 79 77 | 6f 72 64 6c 69 73 74 09 |.evtkeyw|ordlist.|
|000048c0| d1 54 6f 70 20 6c 65 76 | 65 6c 20 73 79 6e 74 61 |.Top lev|el synta|
|000048d0| 78 20 66 6f 72 20 41 45 | 42 75 69 6c 64 41 70 70 |x for AE|BuildApp|
|000048e0| 6c 65 45 76 65 6e 74 0d | 65 76 74 6b 65 79 77 6f |leEvent.|evtkeywo|
|000048f0| 72 64 70 61 69 72 20 3a | 3a 3d 09 5b 7e 5d 20 69 |rdpair :|:=.[~] i|
|00004900| 64 65 6e 74 20 3a 20 6f | 62 6a 09 d1 4b 65 79 77 |dent : o|bj..Keyw|
|00004910| 6f 72 64 2f 76 61 6c 75 | 65 20 70 61 69 72 0d 65 |ord/valu|e pair.e|
|00004920| 76 74 6b 65 79 77 6f 72 | 64 6c 69 73 74 20 3a 3a |vtkeywor|dlist ::|
|00004930| 3d 09 c7 62 6c 61 6e 6b | c8 09 d1 4c 69 73 74 20 |=..blank|...List |
|00004940| 6f 66 20 73 61 69 64 20 | 70 61 69 72 73 0d 09 65 |of said |pairs..e|
|00004950| 76 74 6b 65 79 77 6f 72 | 64 70 61 69 72 20 5b 20 |vtkeywor|dpair [ |
|00004960| 2c 20 65 76 74 6b 65 79 | 77 6f 72 64 70 61 69 72 |, evtkey|wordpair|
|00004970| 20 5d 2a 0d 09 0d 54 68 | 65 72 65 2e 20 4e 6f 77 | ]*...Th|ere. Now|
|00004980| 20 69 74 d5 73 20 61 6c | 6c 20 63 72 79 73 74 61 | it.s al|l crysta|
|00004990| 6c 2d 63 6c 65 61 72 2c | 20 72 69 67 68 74 3f 0d |l-clear,| right?.|
|000049a0| 0d 41 6e 20 45 78 61 6d | 70 6c 65 20 26 20 54 69 |.An Exam|ple & Ti|
|000049b0| 6d 69 6e 67 20 43 6f 6d | 70 61 72 69 73 6f 6e 0d |ming Com|parison.|
|000049c0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|000049d0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 0d 0d |--------|------..|
|000049e0| 41 73 20 61 6e 20 65 78 | 61 6d 70 6c 65 2c 20 49 |As an ex|ample, I|
|000049f0| d5 6c 6c 20 74 61 6b 65 | 20 61 20 43 20 66 75 6e |.ll take| a C fun|
|00004a00| 63 74 69 6f 6e 20 74 6f | 20 67 65 6e 65 72 61 74 |ction to| generat|
|00004a10| 65 20 61 6e 20 6f 62 6a | 65 63 74 20 64 65 73 63 |e an obj|ect desc|
|00004a20| 72 69 70 74 6f 72 20 28 | 74 61 6b 65 6e 20 66 72 |riptor (|taken fr|
|00004a30| 6f 6d 20 0d 61 20 50 61 | 73 63 61 6c 20 65 78 61 |om .a Pa|scal exa|
|00004a40| 6d 70 6c 65 20 69 6e 20 | 74 68 65 20 4f 62 6a 65 |mple in |the Obje|
|00004a50| 63 74 20 4d 6f 64 65 6c | 20 45 52 53 2c 20 66 6c |ct Model| ERS, fl|
|00004a60| 65 73 68 65 64 20 6f 75 | 74 20 61 6e 64 20 77 69 |eshed ou|t and wi|
|00004a70| 74 68 20 67 6f 62 73 20 | 6f 66 20 65 72 72 6f 72 |th gobs |of error|
|00004a80| 20 0d 63 68 65 63 6b 69 | 6e 67 20 61 64 64 65 64 | .checki|ng added|
|00004a90| 29 20 61 6e 64 20 74 75 | 72 6e 20 69 74 20 69 6e |) and tu|rn it in|
|00004aa0| 74 6f 20 61 20 63 61 6c | 6c 20 74 6f 20 41 45 42 |to a cal|l to AEB|
|00004ab0| 75 69 6c 64 2e 20 54 68 | 65 20 6f 62 6a 65 63 74 |uild. Th|e object|
|00004ac0| 20 64 65 73 63 72 69 70 | 74 6f 72 20 77 65 20 77 | descrip|tor we w|
|00004ad0| 61 6e 74 20 0d 74 6f 20 | 67 65 6e 65 72 61 74 65 |ant .to |generate|
|00004ae0| 20 69 73 3a 0d 0d 46 69 | 72 73 74 20 6c 69 6e 65 | is:..Fi|rst line|
|00004af0| 20 6f 66 20 64 6f 63 75 | 6d 65 6e 74 20 27 53 70 | of docu|ment 'Sp|
|00004b00| 69 6e 6e 61 6b 65 72 27 | 20 77 68 6f 73 65 20 66 |innaker'| whose f|
|00004b10| 69 72 73 74 20 77 6f 72 | 64 20 69 73 20 27 41 70 |irst wor|d is 'Ap|
|00004b20| 72 69 6c 27 0d 61 6e 64 | 20 77 68 6f 73 65 20 73 |ril'.and| whose s|
|00004b30| 65 63 6f 6e 64 20 77 6f | 72 64 20 69 73 20 27 69 |econd wo|rd is 'i|
|00004b40| 73 27 0d 0d 54 68 65 6e | 20 49 d5 6c 6c 20 65 78 |s'..Then| I.ll ex|
|00004b50| 65 63 75 74 65 20 62 6f | 74 68 20 66 75 6e 63 74 |ecute bo|th funct|
|00004b60| 69 6f 6e 73 20 61 6e 64 | 20 63 6f 6d 70 61 72 65 |ions and| compare|
|00004b70| 20 74 68 65 69 72 20 65 | 78 65 63 75 74 69 6f 6e | their e|xecution|
|00004b80| 20 74 69 6d 65 73 2e 0d | 0d 43 20 43 6f 64 65 20 | times..|.C Code |
|00004b90| 55 73 69 6e 67 20 4f 62 | 6a 65 63 74 2d 50 61 63 |Using Ob|ject-Pac|
|00004ba0| 6b 69 6e 67 20 4c 69 62 | 72 61 72 79 0d 0d 4f 53 |king Lib|rary..OS|
|00004bb0| 45 72 72 0d 42 75 69 6c | 64 42 79 48 61 6e 64 28 |Err.Buil|dByHand(|
|00004bc0| 20 41 45 44 65 73 63 20 | 2a 64 44 6f 63 75 6d 65 | AEDesc |*dDocume|
|00004bd0| 6e 74 2c 20 41 45 44 65 | 73 63 20 2a 74 68 65 52 |nt, AEDe|sc *theR|
|00004be0| 65 73 75 6c 74 4f 62 6a | 20 29 0d 7b 0d 09 4f 53 |esultObj| ).{..OS|
|00004bf0| 45 72 72 20 65 72 72 3b | 0d 09 41 45 44 65 73 63 |Err err;|..AEDesc|
|00004c00| 20 64 4f 62 6a 65 63 74 | 45 78 61 6d 69 6e 65 64 | dObject|Examined|
|00004c10| 2c 20 64 4e 75 6d 2c 20 | 64 57 6f 72 64 31 2c 20 |, dNum, |dWord1, |
|00004c20| 64 57 6f 72 64 32 2c 20 | 64 41 70 72 69 6c 54 65 |dWord2, |dAprilTe|
|00004c30| 78 74 2c 20 64 49 73 54 | 65 78 74 2c 0d 09 09 20 |xt, dIsT|ext,... |
|00004c40| 20 20 64 43 6f 6d 70 61 | 72 69 73 6f 6e 31 2c 20 |  dCompa|rison1, |
|00004c50| 64 43 6f 6d 70 61 72 69 | 73 6f 6e 32 2c 20 64 4c |dCompari|son2, dL|
|00004c60| 6f 67 69 63 61 6c 54 65 | 72 6d 73 2c 20 64 54 68 |ogicalTe|rms, dTh|
|00004c70| 65 54 65 73 74 2c 20 64 | 4c 69 6e 65 4f 6e 65 2c |eTest, d|LineOne,|
|00004c80| 20 64 54 65 73 74 65 64 | 4c 69 6e 65 73 3b 0d 09 | dTested|Lines;..|
|00004c90| 0d 09 64 4f 62 6a 65 63 | 74 45 78 61 6d 69 6e 65 |..dObjec|tExamine|
|00004ca0| 64 2e 64 61 74 61 48 61 | 6e 64 6c 65 20 3d 09 2f |d.dataHa|ndle =./|
|00004cb0| 2a 20 5a 65 72 6f 20 74 | 68 69 6e 67 73 20 74 6f |* Zero t|hings to|
|00004cc0| 20 73 74 61 72 74 20 6f | 75 74 20 77 69 74 68 20 | start o|ut with |
|00004cd0| 73 6f 20 77 65 20 63 61 | 6e 20 73 61 66 65 6c 79 |so we ca|n safely|
|00004ce0| 20 2a 2f 0d 09 09 64 4e | 75 6d 2e 64 61 74 61 48 | */...dN|um.dataH|
|00004cf0| 61 6e 64 6c 65 20 3d 09 | 09 09 09 2f 2a 20 65 78 |andle =.|.../* ex|
|00004d00| 65 63 75 74 65 20 6f 75 | 72 20 66 61 69 6c 20 63 |ecute ou|r fail c|
|00004d10| 6f 64 65 20 69 66 20 74 | 68 69 6e 67 73 20 64 6f |ode if t|hings do|
|00004d20| 6e 27 74 20 77 6f 72 6b | 20 6f 75 74 20 2a 2f 0d |n't work| out */.|
|00004d30| 09 09 64 57 6f 72 64 31 | 2e 64 61 74 61 48 61 6e |..dWord1|.dataHan|
|00004d40| 64 6c 65 20 3d 0d 09 09 | 64 57 6f 72 64 32 2e 64 |dle =...|dWord2.d|
|00004d50| 61 74 61 48 61 6e 64 6c | 65 20 3d 0d 09 09 64 41 |ataHandl|e =...dA|
|00004d60| 70 72 69 6c 54 65 78 74 | 2e 64 61 74 61 48 61 6e |prilText|.dataHan|
|00004d70| 64 6c 65 20 3d 0d 09 09 | 64 49 73 54 65 78 74 2e |dle =...|dIsText.|
|00004d80| 64 61 74 61 48 61 6e 64 | 6c 65 20 3d 0d 09 09 64 |dataHand|le =...d|
|00004d90| 43 6f 6d 70 61 72 69 73 | 6f 6e 31 2e 64 61 74 61 |Comparis|on1.data|
|00004da0| 48 61 6e 64 6c 65 20 3d | 0d 09 09 64 43 6f 6d 70 |Handle =|...dComp|
|00004db0| 61 72 69 73 6f 6e 32 2e | 64 61 74 61 48 61 6e 64 |arison2.|dataHand|
|00004dc0| 6c 65 20 3d 0d 09 09 64 | 4c 6f 67 69 63 61 6c 54 |le =...d|LogicalT|
|00004dd0| 65 72 6d 73 2e 64 61 74 | 61 48 61 6e 64 6c 65 20 |erms.dat|aHandle |
|00004de0| 3d 0d 09 09 64 54 68 65 | 54 65 73 74 2e 64 61 74 |=...dThe|Test.dat|
|00004df0| 61 48 61 6e 64 6c 65 20 | 3d 0d 09 09 64 4c 69 6e |aHandle |=...dLin|
|00004e00| 65 4f 6e 65 2e 64 61 74 | 61 48 61 6e 64 6c 65 20 |eOne.dat|aHandle |
|00004e10| 3d 0d 09 09 64 54 65 73 | 74 65 64 4c 69 6e 65 73 |=...dTes|tedLines|
|00004e20| 2e 64 61 74 61 48 61 6e | 64 6c 65 20 3d 0d 09 09 |.dataHan|dle =...|
|00004e30| 09 4e 49 4c 3b 0d 0d 09 | 69 66 28 20 65 72 72 3d |.NIL;...|if( err=|
|00004e40| 20 41 45 43 72 65 61 74 | 65 44 65 73 63 28 20 27 | AECreat|eDesc( '|
|00004e50| 65 78 6d 6e 27 2c 20 4e | 49 4c 2c 20 30 2c 20 26 |exmn', N|IL, 0, &|
|00004e60| 64 4f 62 6a 65 63 74 45 | 78 61 6d 69 6e 65 64 20 |dObjectE|xamined |
|00004e70| 29 20 29 0d 09 09 67 6f | 74 6f 20 66 61 69 6c 3b |) )...go|to fail;|
|00004e80| 0d 0d 09 69 66 28 20 65 | 72 72 3d 20 4d 61 6b 65 |...if( e|rr= Make|
|00004e90| 49 6e 64 65 78 44 65 73 | 63 72 69 70 74 6f 72 28 |IndexDes|criptor(|
|00004ea0| 31 2c 26 64 4e 75 6d 29 | 20 29 0d 09 09 67 6f 74 |1,&dNum)| )...got|
|00004eb0| 6f 20 66 61 69 6c 3b 0d | 09 69 66 28 20 65 72 72 |o fail;.|.if( err|
|00004ec0| 3d 20 4d 61 6b 65 4f 62 | 6a 44 65 73 63 72 69 70 |= MakeOb|jDescrip|
|00004ed0| 74 6f 72 28 20 27 77 6f | 72 64 27 2c 20 26 64 4f |tor( 'wo|rd', &dO|
|00004ee0| 62 6a 65 63 74 45 78 61 | 6d 69 6e 65 64 2c 20 66 |bjectExa|mined, f|
|00004ef0| 6f 72 6d 49 6e 64 65 78 | 2c 20 26 64 4e 75 6d 2c |ormIndex|, &dNum,|
|00004f00| 0d 09 09 09 09 09 66 61 | 6c 73 65 2c 20 26 64 57 |......fa|lse, &dW|
|00004f10| 6f 72 64 31 29 20 29 0d | 09 09 67 6f 74 6f 20 66 |ord1) ).|..goto f|
|00004f20| 61 69 6c 3b 0d 09 69 66 | 28 20 65 72 72 3d 20 41 |ail;..if|( err= A|
|00004f30| 45 43 72 65 61 74 65 44 | 65 73 63 28 20 27 54 45 |ECreateD|esc( 'TE|
|00004f40| 58 54 27 2c 20 22 41 70 | 72 69 6c 22 2c 20 35 2c |XT', "Ap|ril", 5,|
|00004f50| 20 26 64 41 70 72 69 6c | 54 65 78 74 20 29 20 29 | &dApril|Text ) )|
|00004f60| 0d 09 09 67 6f 74 6f 20 | 66 61 69 6c 3b 0d 0d 09 |...goto |fail;...|
|00004f70| 41 45 44 69 73 70 6f 73 | 65 44 65 73 63 28 26 64 |AEDispos|eDesc(&d|
|00004f80| 4e 75 6d 29 3b 0d 09 69 | 66 28 20 65 72 72 3d 20 |Num);..i|f( err= |
|00004f90| 4d 61 6b 65 49 6e 64 65 | 78 44 65 73 63 72 69 70 |MakeInde|xDescrip|
|00004fa0| 74 6f 72 28 32 2c 26 64 | 4e 75 6d 29 20 29 0d 09 |tor(2,&d|Num) )..|
|00004fb0| 09 67 6f 74 6f 20 66 61 | 69 6c 3b 0d 09 69 66 28 |.goto fa|il;..if(|
|00004fc0| 20 65 72 72 3d 20 4d 61 | 6b 65 4f 62 6a 44 65 73 | err= Ma|keObjDes|
|00004fd0| 63 72 69 70 74 6f 72 28 | 20 27 77 6f 72 64 27 2c |criptor(| 'word',|
|00004fe0| 20 26 64 4f 62 6a 65 63 | 74 45 78 61 6d 69 6e 65 | &dObjec|tExamine|
|00004ff0| 64 2c 20 66 6f 72 6d 49 | 6e 64 65 78 2c 20 26 64 |d, formI|ndex, &d|
|00005000| 4e 75 6d 2c 0d 09 09 09 | 09 09 74 72 75 65 2c 20 |Num,....|..true, |
|00005010| 26 64 57 6f 72 64 32 29 | 20 29 0d 09 09 67 6f 74 |&dWord2)| )...got|
|00005020| 6f 20 66 61 69 6c 3b 0d | 09 69 66 28 20 65 72 72 |o fail;.|.if( err|
|00005030| 3d 20 41 45 43 72 65 61 | 74 65 44 65 73 63 28 20 |= AECrea|teDesc( |
|00005040| 27 54 45 58 54 27 2c 20 | 22 69 73 22 2c 20 32 2c |'TEXT', |"is", 2,|
|00005050| 20 26 64 49 73 54 65 78 | 74 20 29 20 29 0d 09 09 | &dIsTex|t ) )...|
|00005060| 67 6f 74 6f 20 66 61 69 | 6c 3b 0d 0d 09 69 66 28 |goto fai|l;...if(|
|00005070| 20 65 72 72 3d 20 4d 61 | 6b 65 43 6f 6d 70 44 65 | err= Ma|keCompDe|
|00005080| 73 63 72 69 70 74 6f 72 | 28 20 27 3d 20 20 20 27 |scriptor|( '=   '|
|00005090| 2c 20 26 64 41 70 72 69 | 6c 54 65 78 74 2c 20 26 |, &dApri|lText, &|
|000050a0| 64 57 6f 72 64 31 2c 20 | 74 72 75 65 2c 20 26 64 |dWord1, |true, &d|
|000050b0| 43 6f 6d 70 61 72 69 73 | 6f 6e 31 20 29 20 29 0d |Comparis|on1 ) ).|
|000050c0| 09 09 67 6f 74 6f 20 66 | 61 69 6c 3b 0d 09 69 66 |..goto f|ail;..if|
|000050d0| 28 20 65 72 72 3d 20 4d | 61 6b 65 43 6f 6d 70 44 |( err= M|akeCompD|
|000050e0| 65 73 63 72 69 70 74 6f | 72 28 20 27 3d 20 20 20 |escripto|r( '=   |
|000050f0| 27 2c 20 26 64 49 73 54 | 65 78 74 2c 09 20 20 26 |', &dIsT|ext,.  &|
|00005100| 64 57 6f 72 64 32 2c 20 | 74 72 75 65 2c 20 26 64 |dWord2, |true, &d|
|00005110| 43 6f 6d 70 61 72 69 73 | 6f 6e 32 20 29 20 29 0d |Comparis|on2 ) ).|
|00005120| 09 09 67 6f 74 6f 20 66 | 61 69 6c 3b 0d 0d 09 69 |..goto f|ail;...i|
|00005130| 66 28 20 65 72 72 3d 20 | 41 45 43 72 65 61 74 65 |f( err= |AECreate|
|00005140| 4c 69 73 74 28 20 4e 49 | 4c 2c 20 30 2c 20 66 61 |List( NI|L, 0, fa|
|00005150| 6c 73 65 2c 20 26 64 4c | 6f 67 69 63 61 6c 54 65 |lse, &dL|ogicalTe|
|00005160| 72 6d 73 20 29 20 29 0d | 09 09 67 6f 74 6f 20 66 |rms ) ).|..goto f|
|00005170| 61 69 6c 3b 0d 09 69 66 | 28 20 65 72 72 3d 20 41 |ail;..if|( err= A|
|00005180| 45 50 75 74 44 65 73 63 | 28 20 64 4c 6f 67 69 63 |EPutDesc|( dLogic|
|00005190| 61 6c 54 65 72 6d 73 2c | 20 31 2c 20 64 43 6f 6d |alTerms,| 1, dCom|
|000051a0| 70 61 72 69 73 6f 6e 31 | 20 29 20 29 0d 09 09 67 |parison1| ) )...g|
|000051b0| 6f 74 6f 20 66 61 69 6c | 3b 0d 09 69 66 28 20 65 |oto fail|;..if( e|
|000051c0| 72 72 3d 20 41 45 50 75 | 74 44 65 73 63 28 20 64 |rr= AEPu|tDesc( d|
|000051d0| 4c 6f 67 69 63 61 6c 54 | 65 72 6d 73 2c 20 32 2c |LogicalT|erms, 2,|
|000051e0| 20 64 43 6f 6d 70 61 72 | 69 73 6f 6e 32 20 29 20 | dCompar|ison2 ) |
|000051f0| 29 0d 09 09 67 6f 74 6f | 20 66 61 69 6c 3b 0d 09 |)...goto| fail;..|
|00005200| 09 0d 09 41 45 44 69 73 | 70 6f 73 65 44 65 73 63 |...AEDis|poseDesc|
|00005210| 28 26 64 43 6f 6d 70 61 | 72 69 73 6f 6e 31 29 3b |(&dCompa|rison1);|
|00005220| 0d 09 41 45 44 69 73 70 | 6f 73 65 44 65 73 63 28 |..AEDisp|oseDesc(|
|00005230| 26 64 43 6f 6d 70 61 72 | 69 73 6f 6e 32 29 3b 0d |&dCompar|ison2);.|
|00005240| 09 0d 09 69 66 28 20 65 | 72 72 3d 20 4d 61 6b 65 |...if( e|rr= Make|
|00005250| 4c 6f 67 69 63 61 6c 44 | 65 73 63 72 69 70 74 6f |LogicalD|escripto|
|00005260| 72 28 20 26 64 4c 6f 67 | 69 63 61 6c 54 65 72 6d |r( &dLog|icalTerm|
|00005270| 73 2c 20 27 41 4e 44 20 | 27 2c 20 74 72 75 65 2c |s, 'AND |', true,|
|00005280| 20 26 64 54 68 65 54 65 | 73 74 29 20 29 0d 09 09 | &dTheTe|st) )...|
|00005290| 67 6f 74 6f 20 66 61 69 | 6c 3b 0d 09 0d 09 69 66 |goto fai|l;....if|
|000052a0| 28 20 65 72 72 3d 20 4d | 61 6b 65 4f 62 6a 44 65 |( err= M|akeObjDe|
|000052b0| 73 63 72 69 70 74 6f 72 | 28 63 6c 61 73 73 4c 69 |scriptor|(classLi|
|000052c0| 6e 65 2c 26 64 44 6f 63 | 75 6d 65 6e 74 2c 66 6f |ne,&dDoc|ument,fo|
|000052d0| 72 6d 54 65 73 74 2c 26 | 64 54 68 65 54 65 73 74 |rmTest,&|dTheTest|
|000052e0| 2c 74 72 75 65 2c 0d 09 | 09 09 09 09 09 09 09 09 |,true,..|........|
|000052f0| 26 64 54 65 73 74 65 64 | 4c 69 6e 65 73 29 20 29 |&dTested|Lines) )|
|00005300| 0d 09 09 67 6f 74 6f 20 | 66 61 69 6c 3b 0d 0d 09 |...goto |fail;...|
|00005310| 69 66 28 20 65 72 72 3d | 20 4d 61 6b 65 49 6e 64 |if( err=| MakeInd|
|00005320| 65 78 44 65 73 63 72 69 | 70 74 6f 72 28 31 2c 26 |exDescri|ptor(1,&|
|00005330| 64 4c 69 6e 65 4f 6e 65 | 29 20 29 0d 09 09 67 6f |dLineOne|) )...go|
|00005340| 74 6f 20 66 61 69 6c 3b | 0d 09 69 66 28 20 65 72 |to fail;|..if( er|
|00005350| 72 3d 20 4d 61 6b 65 4f | 62 6a 44 65 73 63 72 69 |r= MakeO|bjDescri|
|00005360| 70 74 6f 72 28 20 63 6c | 61 73 73 4c 69 6e 65 2c |ptor( cl|assLine,|
|00005370| 20 26 64 54 65 73 74 65 | 64 4c 69 6e 65 73 2c 20 | &dTeste|dLines, |
|00005380| 66 6f 72 6d 49 6e 64 65 | 78 2c 20 26 64 4c 69 6e |formInde|x, &dLin|
|00005390| 65 4f 6e 65 2c 0d 09 09 | 09 74 72 75 65 2c 20 74 |eOne,...|.true, t|
|000053a0| 68 65 52 65 73 75 6c 74 | 4f 62 6a 20 29 20 29 0d |heResult|Obj ) ).|
|000053b0| 09 09 67 6f 74 6f 20 66 | 61 69 6c 3b 0d 09 72 65 |..goto f|ail;..re|
|000053c0| 74 75 72 6e 20 6e 6f 45 | 72 72 3b 0d 09 0d 66 61 |turn noE|rr;...fa|
|000053d0| 69 6c 3a 09 09 09 09 09 | 09 09 09 09 09 09 2f 2a |il:.....|....../*|
|000053e0| 20 43 6c 65 61 6e 20 75 | 70 20 69 6e 20 63 61 73 | Clean u|p in cas|
|000053f0| 65 20 77 65 20 63 6f 75 | 6c 64 6e 27 74 20 62 75 |e we cou|ldn't bu|
|00005400| 69 6c 64 20 69 74 20 2a | 2f 0d 09 41 45 44 69 73 |ild it *|/..AEDis|
|00005410| 70 6f 73 65 44 65 73 63 | 28 74 68 65 52 65 73 75 |poseDesc|(theResu|
|00005420| 6c 74 4f 62 6a 29 3b 0d | 09 41 45 44 69 73 70 6f |ltObj);.|.AEDispo|
|00005430| 73 65 44 65 73 63 28 26 | 64 4f 62 6a 65 63 74 45 |seDesc(&|dObjectE|
|00005440| 78 61 6d 69 6e 65 64 29 | 3b 0d 09 41 45 44 69 73 |xamined)|;..AEDis|
|00005450| 70 6f 73 65 44 65 73 63 | 28 26 64 4e 75 6d 29 3b |poseDesc|(&dNum);|
|00005460| 0d 09 41 45 44 69 73 70 | 6f 73 65 44 65 73 63 28 |..AEDisp|oseDesc(|
|00005470| 26 64 57 6f 72 64 31 29 | 3b 0d 09 41 45 44 69 73 |&dWord1)|;..AEDis|
|00005480| 70 6f 73 65 44 65 73 63 | 28 26 64 57 6f 72 64 32 |poseDesc|(&dWord2|
|00005490| 29 3b 0d 09 41 45 44 69 | 73 70 6f 73 65 44 65 73 |);..AEDi|sposeDes|
|000054a0| 63 28 26 64 41 70 72 69 | 6c 54 65 78 74 29 3b 0d |c(&dApri|lText);.|
|000054b0| 09 41 45 44 69 73 70 6f | 73 65 44 65 73 63 28 26 |.AEDispo|seDesc(&|
|000054c0| 64 49 73 54 65 78 74 29 | 3b 0d 09 41 45 44 69 73 |dIsText)|;..AEDis|
|000054d0| 70 6f 73 65 44 65 73 63 | 28 26 64 43 6f 6d 70 61 |poseDesc|(&dCompa|
|000054e0| 72 69 73 6f 6e 31 29 3b | 0d 09 41 45 44 69 73 70 |rison1);|..AEDisp|
|000054f0| 6f 73 65 44 65 73 63 28 | 26 64 43 6f 6d 70 61 72 |oseDesc(|&dCompar|
|00005500| 69 73 6f 6e 32 29 3b 0d | 09 41 45 44 69 73 70 6f |ison2);.|.AEDispo|
|00005510| 73 65 44 65 73 63 28 26 | 64 4c 6f 67 69 63 61 6c |seDesc(&|dLogical|
|00005520| 54 65 72 6d 73 29 3b 0d | 09 41 45 44 69 73 70 6f |Terms);.|.AEDispo|
|00005530| 73 65 44 65 73 63 28 26 | 64 54 68 65 54 65 73 74 |seDesc(&|dTheTest|
|00005540| 29 3b 0d 09 41 45 44 69 | 73 70 6f 73 65 44 65 73 |);..AEDi|sposeDes|
|00005550| 63 28 26 64 4c 69 6e 65 | 4f 6e 65 29 3b 0d 09 41 |c(&dLine|One);..A|
|00005560| 45 44 69 73 70 6f 73 65 | 44 65 73 63 28 26 64 54 |EDispose|Desc(&dT|
|00005570| 65 73 74 65 64 4c 69 6e | 65 73 29 3b 0d 09 0d 09 |estedLin|es);....|
|00005580| 72 65 74 75 72 6e 20 65 | 72 72 3b 0d 7d 0d 0d 4d |return e|rr;.}..M|
|00005590| 50 57 20 33 2e 32 62 35 | 20 43 20 63 6f 6d 70 69 |PW 3.2b5| C compi|
|000055a0| 6c 65 64 20 74 68 69 73 | 20 69 6e 74 6f 20 38 31 |led this| into 81|
|000055b0| 36 20 62 79 74 65 73 20 | 6f 66 20 6f 62 6a 65 63 |6 bytes |of objec|
|000055c0| 74 20 63 6f 64 65 2e 0d | 49 20 66 6f 75 6e 64 20 |t code..|I found |
|000055d0| 74 68 61 74 20 74 68 65 | 20 61 76 65 72 61 67 65 |that the| average|
|000055e0| 20 74 69 6d 65 20 74 6f | 20 65 78 65 63 75 74 65 | time to| execute|
|000055f0| 20 74 68 69 73 20 66 75 | 6e 63 74 69 6f 6e 20 77 | this fu|nction w|
|00005600| 61 73 20 30 2e 30 31 38 | 38 20 73 65 63 6f 6e 64 |as 0.018|8 second|
|00005610| 73 20 0d 28 51 75 61 64 | 72 61 20 37 30 30 29 20 |s .(Quad|ra 700) |
|00005620| 6f 72 20 30 2e 30 31 31 | 33 20 73 65 63 6f 6e 64 |or 0.011|3 second|
|00005630| 73 20 28 49 49 66 78 29 | 2e a0 20 55 73 65 20 74 |s (IIfx)|.. Use t|
|00005640| 68 69 73 20 66 69 67 75 | 72 65 20 66 6f 72 20 63 |his figu|re for c|
|00005650| 6f 6d 70 61 72 69 73 6f | 6e 20 6f 6e 6c 79 3b 20 |ompariso|n only; |
|00005660| 79 6f 75 72 20 0d 74 69 | 6d 65 73 20 6d 61 79 20 |your .ti|mes may |
|00005670| 76 61 72 79 2e 20 54 68 | 65 20 74 69 6d 69 6e 67 |vary. Th|e timing|
|00005680| 20 69 73 20 65 73 70 65 | 63 69 61 6c 6c 79 20 64 | is espe|cially d|
|00005690| 65 70 65 6e 64 65 6e 74 | 20 6f 6e 20 74 68 65 20 |ependent| on the |
|000056a0| 6e 75 6d 62 65 72 20 6f | 66 20 62 6c 6f 63 6b 73 |number o|f blocks|
|000056b0| 20 69 6e 20 0d 74 68 65 | 20 68 65 61 70 2c 20 73 | in .the| heap, s|
|000056c0| 69 6e 63 65 20 73 6f 20 | 6d 61 6e 79 20 62 6c 6f |ince so |many blo|
|000056d0| 63 6b 20 61 6c 6c 6f 63 | 61 74 69 6f 6e 73 20 61 |ck alloc|ations a|
|000056e0| 6e 64 20 64 69 73 70 6f | 73 61 6c 73 20 61 72 65 |nd dispo|sals are|
|000056f0| 20 68 61 70 70 65 6e 69 | 6e 67 2e 0d 0d 41 70 70 | happeni|ng...App|
|00005700| 6c 65 53 63 72 69 70 74 | 0d 0d 46 69 72 73 74 20 |leScript|..First |
|00005710| 6c 69 6e 65 20 6f 66 20 | 64 6f 63 75 6d 65 6e 74 |line of |document|
|00005720| 20 27 53 70 69 6e 6e 61 | 6b 65 72 27 20 77 68 6f | 'Spinna|ker' who|
|00005730| 73 65 20 66 69 72 73 74 | 20 77 6f 72 64 20 69 73 |se first| word is|
|00005740| 20 27 41 70 72 69 6c 27 | 0d 61 6e 64 20 77 68 6f | 'April'|.and who|
|00005750| 73 65 20 73 65 63 6f 6e | 64 20 77 6f 72 64 20 69 |se secon|d word i|
|00005760| 73 20 27 69 73 27 0d 0d | 44 65 73 63 72 69 70 74 |s 'is'..|Descript|
|00005770| 6f 72 20 53 74 72 69 6e | 67 0d 0d 6f 62 6a 7b 20 |or Strin|g..obj{ |
|00005780| 77 61 6e 74 3a 74 79 70 | 65 28 27 6c 69 6e 65 27 |want:typ|e('line'|
|00005790| 29 2c 0d 20 20 20 20 20 | 66 72 6f 6d 3a 20 6f 62 |),.     |from: ob|
|000057a0| 6a 7b 20 77 61 6e 74 3a | 20 74 79 70 65 28 27 6c |j{ want:| type('l|
|000057b0| 69 6e 65 27 29 2c 20 66 | 72 6f 6d 3a 20 40 2c 20 |ine'), f|rom: @, |
|000057c0| 66 6f 72 6d 3a 20 27 74 | 65 73 74 27 2c 0d 20 20 |form: 't|est',.  |
|000057d0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 73 65 |        |      se|
|000057e0| 6c 64 3a 20 6c 6f 67 69 | 7b 0d 20 20 20 20 20 20 |ld: logi|{.      |
|000057f0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00005800| 20 20 20 20 20 74 65 72 | 6d 3a 20 5b 63 6f 6d 70 |     ter|m: [comp|
|00005810| 7b 20 72 65 6c 6f 3a 3d | 2c 20 6f 62 6a 31 3a d2 |{ relo:=|, obj1:.|
|00005820| 41 70 72 69 6c d3 2c 0d | 20 20 20 20 20 20 20 20 |April.,.|        |
|00005830| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00005840| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00005850| 6f 62 6a 32 3a 6f 62 6a | 7b 20 77 61 6e 74 3a 74 |obj2:obj|{ want:t|
|00005860| 79 70 65 28 27 77 6f 72 | 64 27 29 2c 20 66 72 6f |ype('wor|d'), fro|
|00005870| 6d 3a 65 78 6d 6e 28 29 | 2c 20 0d 20 20 20 20 20 |m:exmn()|, .     |
|00005880| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00005890| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|000058a0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 66 6f 72 |        |     for|
|000058b0| 6d 3a 69 6e 64 78 2c 20 | 73 65 6c 64 3a 31 20 7d |m:indx, |seld:1 }|
|000058c0| 0d 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |.       |        |
|000058d0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|000058e0| 20 20 20 20 20 20 20 7d | 2c 0d 20 20 20 20 20 20 |       }|,.      |
|000058f0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00005900| 20 20 20 20 20 20 20 20 | 20 20 20 20 63 6f 6d 70 |        |    comp|
|00005910| 7b 20 72 65 6c 6f 3a 3d | 2c 20 6f 62 6a 31 3a d2 |{ relo:=|, obj1:.|
|00005920| 69 73 d3 2c 0d 20 20 20 | 20 20 20 20 20 20 20 20 |is.,.   |        |
|00005930| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00005940| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 6f 62 6a |        |     obj|
|00005950| 32 3a 6f 62 6a 7b 20 77 | 61 6e 74 3a 74 79 70 65 |2:obj{ w|ant:type|
|00005960| 28 27 77 6f 72 64 27 29 | 2c 20 66 72 6f 6d 3a 65 |('word')|, from:e|
|00005970| 78 6d 6e 28 29 2c 0d 20 | 20 20 20 20 20 20 20 20 |xmn(),. |        |
|00005980| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00005990| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|000059a0| 20 20 20 20 20 20 20 20 | 20 66 6f 72 6d 3a 69 6e |        | form:in|
|000059b0| 64 78 2c 20 73 65 6c 64 | 3a 32 20 7d 0d 20 20 20 |dx, seld|:2 }.   |
|000059c0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|000059d0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|000059e0| 20 20 20 7d 0d 20 20 20 | 20 20 20 20 20 20 20 20 |   }.   |        |
|000059f0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00005a00| 20 20 20 20 20 20 5d 2c | 0d 20 20 20 20 20 20 20 |      ],|.       |
|00005a10| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00005a20| 20 20 20 20 6c 6f 67 63 | 3a 41 4e 44 0d 20 20 20 |    logc|:AND.   |
|00005a30| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00005a40| 20 20 20 20 20 20 7d 0d | 20 20 20 20 20 20 20 20 |      }.|        |
|00005a50| 20 20 20 20 20 20 7d 2c | 0d 20 20 20 20 20 66 6f |      },|.     fo|
|00005a60| 72 6d 3a 20 27 69 6e 64 | 78 27 2c 0d 20 20 20 20 |rm: 'ind|x',.    |
|00005a70| 20 73 65 6c 64 3a 20 31 | 0d 7d 0d 0d 41 45 42 75 | seld: 1|.}..AEBu|
|00005a80| 69 6c 64 20 43 61 6c 6c | 0d 0d 63 68 61 72 20 64 |ild Call|..char d|
|00005a90| 65 73 63 72 69 70 74 6f | 72 5b 5d 20 3d 09 09 09 |escripto|r[] =...|
|00005aa0| 09 2f 2a 20 53 61 6d 65 | 20 64 65 73 63 72 69 70 |./* Same| descrip|
|00005ab0| 74 6f 72 20 73 74 72 69 | 6e 67 20 61 73 20 61 62 |tor stri|ng as ab|
|00005ac0| 6f 76 65 2e 20 4e 6f 74 | 65 20 63 6c 65 76 65 72 |ove. Not|e clever|
|00005ad0| 20 2a 2f 0d 22 6f 62 6a | 7b 20 77 61 6e 74 3a 74 | */."obj|{ want:t|
|00005ae0| 79 70 65 28 27 6c 69 6e | 65 27 29 2c 22 09 09 2f |ype('lin|e'),"../|
|00005af0| 2a 20 6d 65 74 68 6f 64 | 20 75 73 65 64 20 74 6f |* method| used to|
|00005b00| 20 62 72 65 61 6b 20 73 | 74 72 69 6e 67 20 61 63 | break s|tring ac|
|00005b10| 72 6f 73 73 20 6c 69 6e | 65 73 2e 20 2a 2f 0d 20 |ross lin|es. */. |
|00005b20| 20 20 20 22 66 72 6f 6d | 3a 20 6f 62 6a 7b 20 77 |   "from|: obj{ w|
|00005b30| 61 6e 74 3a 20 74 79 70 | 65 28 27 6c 69 6e 65 27 |ant: typ|e('line'|
|00005b40| 29 2c 20 66 72 6f 6d 3a | 20 40 2c 20 66 6f 72 6d |), from:| @, form|
|00005b50| 3a 20 27 74 65 73 74 27 | 2c 22 09 09 2f 2a 20 4e |: 'test'|,"../* N|
|00005b60| 6f 74 65 20 70 61 72 61 | 6d 65 74 65 72 20 68 65 |ote para|meter he|
|00005b70| 72 65 20 2a 2f 0d 20 20 | 20 20 20 20 20 20 20 20 |re */.  |        |
|00005b80| 20 20 20 20 20 22 73 65 | 6c 64 3a 20 6c 6f 67 69 |     "se|ld: logi|
|00005b90| 7b 22 0d 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |{".     |        |
|00005ba0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 22 74 65 |        |     "te|
|00005bb0| 72 6d 3a 20 5b 63 6f 6d | 70 7b 20 72 65 6c 6f 3a |rm: [com|p{ relo:|
|00005bc0| 3d 2c 20 6f 62 6a 31 3a | d2 41 70 72 69 6c d3 2c |=, obj1:|.April.,|
|00005bd0| 22 0d 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |".      |        |
|00005be0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00005bf0| 20 20 20 20 20 20 20 20 | 20 22 6f 62 6a 32 3a 22 |        | "obj2:"|
|00005c00| 0d 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |.       |        |
|00005c10| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 22 6f |        |      "o|
|00005c20| 62 6a 7b 20 77 61 6e 74 | 3a 74 79 70 65 28 27 77 |bj{ want|:type('w|
|00005c30| 6f 72 64 27 29 2c 20 66 | 72 6f 6d 3a 65 78 6d 6e |ord'), f|rom:exmn|
|00005c40| 28 29 2c 20 66 6f 72 6d | 3a 69 6e 64 78 2c 20 73 |(), form|:indx, s|
|00005c50| 65 6c 64 3a 31 20 7d 7d | 2c 22 0d 20 20 20 20 20 |eld:1 }}|,".     |
|00005c60| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00005c70| 20 20 20 20 20 20 20 20 | 20 20 20 20 22 63 6f 6d |        |    "com|
|00005c80| 70 7b 20 72 65 6c 6f 3a | 3d 2c 20 6f 62 6a 31 3a |p{ relo:|=, obj1:|
|00005c90| d2 69 73 d3 2c 22 0d 20 | 20 20 20 20 20 20 20 20 |.is.,". |        |
|00005ca0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00005cb0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 22 6f |        |      "o|
|00005cc0| 62 6a 32 3a 22 0d 20 20 | 20 20 20 20 20 20 20 20 |bj2:".  |        |
|00005cd0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00005ce0| 20 20 20 22 6f 62 6a 7b | 20 77 61 6e 74 3a 74 79 |   "obj{| want:ty|
|00005cf0| 70 65 28 27 77 6f 72 64 | 27 29 2c 20 66 72 6f 6d |pe('word|'), from|
|00005d00| 3a 65 78 6d 6e 28 29 2c | 20 66 6f 72 6d 3a 69 6e |:exmn(),| form:in|
|00005d10| 64 78 2c 20 73 65 6c 64 | 3a 32 20 7d 7d 22 0d 20 |dx, seld|:2 }}". |
|00005d20| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00005d30| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 22 |        |       "|
|00005d40| 5d 2c 22 0d 20 20 20 20 | 20 20 20 20 20 20 20 20 |],".    |        |
|00005d50| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 22 6c |        |      "l|
|00005d60| 6f 67 63 3a 41 4e 44 22 | 0d 20 20 20 20 20 20 20 |ogc:AND"|.       |
|00005d70| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00005d80| 20 22 7d 22 0d 20 20 20 | 20 20 20 20 20 20 20 20 | "}".   |        |
|00005d90| 20 20 22 7d 2c 22 0d 20 | 20 20 20 22 66 6f 72 6d |  "},". |   "form|
|00005da0| 3a 20 27 69 6e 64 78 27 | 2c 22 0d 20 20 20 20 22 |: 'indx'|,".    "|
|00005db0| 73 65 6c 64 3a 20 31 22 | 0d 22 7d 22 3b 0d 0d 76 |seld: 1"|."}";..v|
|00005dc0| 6f 69 64 20 50 61 63 6b | 57 6f 72 64 44 65 73 63 |oid Pack|WordDesc|
|00005dd0| 28 20 41 45 44 65 73 63 | 20 2a 64 44 6f 63 75 6d |( AEDesc| *dDocum|
|00005de0| 65 6e 74 4f 62 6a 65 63 | 74 20 29 09 2f 2a 20 d2 |entObjec|t )./* .|
|00005df0| 53 70 69 6e 6e 61 6b 65 | 72 d3 20 64 65 73 63 72 |Spinnake|r. descr|
|00005e00| 69 70 74 6f 72 20 69 73 | 20 61 20 70 61 72 61 6d |iptor is| a param|
|00005e10| 65 74 65 72 20 2a 2f 0d | 7b 0d 09 65 72 72 20 3d |eter */.|{..err =|
|00005e20| 20 41 45 42 75 69 6c 64 | 28 26 74 68 65 52 65 73 | AEBuild|(&theRes|
|00005e30| 75 6c 74 4f 62 6a 2c 0d | 09 09 09 09 09 64 65 73 |ultObj,.|.....des|
|00005e40| 63 72 69 70 74 6f 72 53 | 74 72 69 6e 67 2c 0d 09 |criptorS|tring,..|
|00005e50| 09 09 09 09 64 44 6f 63 | 75 6d 65 6e 74 4f 62 6a |....dDoc|umentObj|
|00005e60| 65 63 74 29 3b 09 09 09 | 09 09 2f 2a 20 41 45 44 |ect);...|../* AED|
|00005e70| 65 73 63 2a 20 70 61 72 | 61 6d 65 74 65 72 20 66 |esc* par|ameter f|
|00005e80| 6f 72 20 22 40 22 20 2a | 2f 0d 7d 0d 0d 4d 50 57 |or "@" *|/.}..MPW|
|00005e90| 20 33 2e 32 62 35 20 43 | 20 63 6f 6d 70 69 6c 65 | 3.2b5 C| compile|
|00005ea0| 64 20 74 68 69 73 20 69 | 6e 74 6f 20 34 32 20 62 |d this i|nto 42 b|
|00005eb0| 79 74 65 73 20 6f 66 20 | 6f 62 6a 65 63 74 20 63 |ytes of |object c|
|00005ec0| 6f 64 65 2c 20 70 6c 75 | 73 20 33 31 30 20 62 79 |ode, plu|s 310 by|
|00005ed0| 74 65 73 20 6f 66 20 64 | 61 74 61 20 0d 73 74 6f |tes of d|ata .sto|
|00005ee0| 72 61 67 65 20 66 6f 72 | 20 74 68 65 20 73 74 72 |rage for| the str|
|00005ef0| 69 6e 67 2e 0d 0d 49 20 | 66 6f 75 6e 64 20 74 68 |ing...I |found th|
|00005f00| 61 74 20 74 68 65 20 61 | 76 65 72 61 67 65 20 74 |at the a|verage t|
|00005f10| 69 6d 65 20 74 6f 20 65 | 78 65 63 75 74 65 20 74 |ime to e|xecute t|
|00005f20| 68 69 73 20 66 75 6e 63 | 74 69 6f 6e 20 77 61 73 |his func|tion was|
|00005f30| 20 30 2e 30 30 34 39 20 | 73 65 63 6f 6e 64 73 20 | 0.0049 |seconds |
|00005f40| 0d 28 51 75 61 64 72 61 | 20 37 30 30 29 20 6f 72 |.(Quadra| 700) or|
|00005f50| 20 30 2e 30 30 37 30 20 | 73 65 63 6f 6e 64 73 20 | 0.0070 |seconds |
|00005f60| 28 49 49 66 78 29 2e 20 | 55 73 65 20 74 68 69 73 |(IIfx). |Use this|
|00005f70| 20 66 69 67 75 72 65 20 | 66 6f 72 20 63 6f 6d 70 | figure |for comp|
|00005f80| 61 72 69 73 6f 6e 20 6f | 6e 6c 79 3b 20 79 6f 75 |arison o|nly; you|
|00005f90| 72 20 0d 74 69 6d 65 73 | 20 6d 61 79 20 76 61 72 |r .times| may var|
|00005fa0| 79 2e 20 54 68 65 20 74 | 69 6d 69 6e 67 20 69 73 |y. The t|iming is|
|00005fb0| 20 64 65 70 65 6e 64 65 | 6e 74 20 6f 6e 20 74 68 | depende|nt on th|
|00005fc0| 65 20 6e 75 6d 62 65 72 | 20 6f 66 20 62 6c 6f 63 |e number| of bloc|
|00005fd0| 6b 73 20 69 6e 20 74 68 | 65 20 68 65 61 70 2c 20 |ks in th|e heap, |
|00005fe0| 0d 73 69 6e 63 65 20 68 | 65 61 70 20 62 6c 6f 63 |.since h|eap bloc|
|00005ff0| 6b 73 20 61 72 65 20 62 | 65 69 6e 67 20 61 6c 6c |ks are b|eing all|
|00006000| 6f 63 61 74 65 64 20 61 | 6e 64 20 72 65 73 69 7a |ocated a|nd resiz|
|00006010| 65 64 2e 0d 0d 54 69 6d | 69 6e 67 20 43 6f 6e 63 |ed...Tim|ing Conc|
|00006020| 6c 75 73 69 6f 6e 73 0d | 0d 57 69 74 68 20 70 72 |lusions.|.With pr|
|00006030| 65 76 69 6f 75 73 20 76 | 65 72 73 69 6f 6e 73 20 |evious v|ersions |
|00006040| 6f 66 20 74 68 69 73 20 | 6c 69 62 72 61 72 79 2c |of this |library,|
|00006050| 20 74 68 65 72 65 20 77 | 61 73 20 61 20 37 30 25 | there w|as a 70%|
|00006060| 20 69 6e 63 72 65 61 73 | 65 20 69 6e 20 65 78 65 | increas|e in exe|
|00006070| 63 75 74 69 6f 6e 20 74 | 69 6d 65 20 0d 77 68 65 |cution t|ime .whe|
|00006080| 6e 20 75 73 69 6e 67 20 | 74 68 65 20 41 45 42 75 |n using |the AEBu|
|00006090| 69 6c 64 20 72 6f 75 74 | 69 6e 65 2e 20 41 66 74 |ild rout|ine. Aft|
|000060a0| 65 72 20 64 65 6c 69 76 | 65 72 69 6e 67 20 74 68 |er deliv|ering th|
|000060b0| 65 20 62 61 64 20 6e 65 | 77 73 2c 20 49 20 77 72 |e bad ne|ws, I wr|
|000060c0| 6f 74 65 3a 0d 48 6f 77 | 65 76 65 72 2c 20 69 66 |ote:.How|ever, if|
|000060d0| 20 73 70 65 65 64 20 64 | 6f 65 73 20 62 65 63 6f | speed d|oes beco|
|000060e0| 6d 65 20 61 6e 20 69 73 | 73 75 65 2c 20 74 68 65 |me an is|sue, the|
|000060f0| 72 65 20 69 73 20 61 6c | 77 61 79 73 20 74 68 65 |re is al|ways the|
|00006100| 20 6f 70 74 69 6f 6e 20 | 6f 66 20 0d 74 75 72 62 | option |of .turb|
|00006110| 6f 63 68 61 72 67 69 6e | 67 20 41 45 42 75 69 6c |ochargin|g AEBuil|
|00006120| 64 20 62 79 20 68 61 76 | 69 6e 67 20 69 74 20 64 |d by hav|ing it d|
|00006130| 69 72 65 63 74 6c 79 20 | 62 75 69 6c 64 20 64 65 |irectly |build de|
|00006140| 73 63 72 69 70 74 6f 72 | 73 20 77 69 74 68 6f 75 |scriptor|s withou|
|00006150| 74 20 67 6f 69 6e 67 20 | 0d 74 68 72 6f 75 67 68 |t going |.through|
|00006160| 20 74 68 65 20 41 70 70 | 6c 65 20 45 76 65 6e 74 | the App|le Event|
|00006170| 20 4d 61 6e 61 67 65 72 | 20 66 75 6e 63 74 69 6f | Manager| functio|
|00006180| 6e 73 20 61 74 20 61 6c | 6c 2e 20 54 68 69 73 20 |ns at al|l. This |
|00006190| 77 6f 75 6c 64 20 73 61 | 76 65 20 61 6e 20 69 6e |would sa|ve an in|
|000061a0| 63 72 65 64 69 62 6c 65 | 20 0d 6e 75 6d 62 65 72 |credible| .number|
|000061b0| 20 6f 66 20 4d 65 6d 6f | 72 79 20 4d 61 6e 61 67 | of Memo|ry Manag|
|000061c0| 65 72 20 63 61 6c 6c 73 | 20 61 6e 64 20 70 72 6f |er calls| and pro|
|000061d0| 62 61 62 6c 79 20 69 6e | 63 72 65 61 73 65 20 70 |bably in|crease p|
|000061e0| 65 72 66 6f 72 6d 61 6e | 63 65 20 0d 73 65 76 65 |erforman|ce .seve|
|000061f0| 72 61 6c 66 6f 6c 64 2e | 20 41 6e 79 6f 6e 65 20 |ralfold.| Anyone |
|00006200| 75 73 69 6e 67 20 41 45 | 42 75 69 6c 64 20 77 69 |using AE|Build wi|
|00006210| 6c 6c 20 67 65 74 20 61 | 6c 6c 20 74 68 65 73 65 |ll get a|ll these|
|00006220| 20 69 6d 70 72 6f 76 65 | 6d 65 6e 74 73 20 66 6f | improve|ments fo|
|00006230| 72 20 66 72 65 65 2e 0d | 54 68 69 73 20 69 73 20 |r free..|This is |
|00006240| 65 78 61 63 74 6c 79 20 | 77 68 61 74 20 49 20 64 |exactly |what I d|
|00006250| 69 64 20 69 6e 20 76 65 | 72 73 69 6f 6e 20 31 2e |id in ve|rsion 1.|
|00006260| 31 2e 20 49 6e 20 66 61 | 63 74 2c 20 49 20 77 72 |1. In fa|ct, I wr|
|00006270| 6f 74 65 20 61 20 6c 69 | 62 72 61 72 79 20 28 41 |ote a li|brary (A|
|00006280| 45 53 74 72 65 61 6d 29 | 20 74 6f 20 0d 64 6f 20 |EStream)| to .do |
|00006290| 69 74 2c 20 73 6f 20 79 | 6f 75 20 63 61 6e 20 64 |it, so y|ou can d|
|000062a0| 6f 20 69 74 20 74 6f 6f | 2e 20 49 74 d5 73 20 65 |o it too|. It.s e|
|000062b0| 61 73 79 2e 0d 41 45 42 | 75 69 6c 64 20 69 73 20 |asy..AEB|uild is |
|000062c0| 6e 6f 77 20 31 2e 35 20 | 74 6f 20 34 20 74 69 6d |now 1.5 |to 4 tim|
|000062d0| 65 73 20 61 73 20 66 61 | 73 74 20 28 64 65 70 65 |es as fa|st (depe|
|000062e0| 6e 64 69 6e 67 20 6f 6e | 20 43 50 55 29 20 61 73 |nding on| CPU) as|
|000062f0| 20 74 68 65 20 75 73 69 | 6e 67 20 74 68 65 20 41 | the usi|ng the A|
|00006300| 70 70 6c 65 20 0d 45 76 | 65 6e 74 20 4d 61 6e 61 |pple .Ev|ent Mana|
|00006310| 67 65 72 20 61 6e 64 2f | 6f 72 20 4f 62 6a 65 63 |ger and/|or Objec|
|00006320| 74 20 50 61 63 6b 69 6e | 67 20 4c 69 62 72 61 72 |t Packin|g Librar|
|00006330| 79 20 72 6f 75 74 69 6e | 65 73 2e 20 28 54 68 69 |y routin|es. (Thi|
|00006340| 73 20 6d 65 61 6e 73 20 | 74 68 61 74 20 0d 41 45 |s means |that .AE|
|00006350| 53 74 72 65 61 6d 20 77 | 61 73 20 72 65 73 70 6f |Stream w|as respo|
|00006360| 6e 73 69 62 6c 65 20 66 | 6f 72 20 61 20 74 68 72 |nsible f|or a thr|
|00006370| 65 65 66 6f 6c 64 20 73 | 70 65 65 64 2d 75 70 20 |eefold s|peed-up |
|00006380| 69 6e 20 41 45 42 75 69 | 6c 64 2e 20 4e 6f 74 20 |in AEBui|ld. Not |
|00006390| 62 61 64 2c 20 77 68 65 | 6e 20 0d 79 6f 75 20 74 |bad, whe|n .you t|
|000063a0| 61 6b 65 20 69 6e 74 6f | 20 61 63 63 6f 75 6e 74 |ake into| account|
|000063b0| 20 6f 74 68 65 72 20 6f | 76 65 72 68 65 61 64 20 | other o|verhead |
|000063c0| 6c 69 6b 65 20 70 61 72 | 73 69 6e 67 20 74 68 65 |like par|sing the|
|000063d0| 20 66 6f 72 6d 61 74 20 | 73 74 72 69 6e 67 21 29 | format |string!)|
|000063e0| 0d 4e 65 65 64 6c 65 73 | 73 20 74 6f 20 73 61 79 |.Needles|s to say|
|000063f0| 2c 20 69 66 20 79 6f 75 | 20 77 65 72 65 20 61 6c |, if you| were al|
+--------+-------------------------+-------------------------+--------+--------+
Only 25.0 KB of data is shown above.